@paralect/native-media-picker

native-media-picker

React-native media picker for IOS and Android. Instagram like designed.

Getting started

Run in react-native project folder: $ npm i @paralect/native-media-picker

Import module in your javascript file

import NativeMediaPicker from '@paralect/native-media-picker';

Usage

Pick image for avatar

const config = {
  imageSideCap : 512,
  showRoundAim : true 
}

NativeMediaPicker.showMediaPicker(config)
  .then( result => { 
    console.log(result.items) 
    console.log(result.isCancelled) 
  } )
  .catch( error => { Alert.alert(error.message) } );

Pick multiple images and save picker state.

const config = {
  imageSideCap : 1024,    	
  maxItems : 5,
  saveState: true
}

NativeMediaPicker.showMediaPicker(config)
  .then( result => { console.log(result) } )
  .catch( error => { Alert.alert(error.message) } );

Show picker with saved state

NativeMediaPicker.showStoredMediaPicker()
  .then( (result) => { console.log(result) } )
  .catch( error => { Alert.alert(error.message) } );

Reset saved picker

NativeMediaPicker.resetPicker()

Configuration variables

Variable	Description	Type	Default value
imageSideCap	Maximum value of the side of the image. Oversized image will be resized proportionally	Integer	1024
maxItems	Count of images to pick. Multiple pick enabled if 1+	Integer	1
showRoundAim	Add round preset	Boolean	false
saveState	Save state of picker after dismissing	Boolean	false
showFilters	Enable option to choose filters for image	Boolean	false

Result dictionary

key	Description	Type
items	Base64 encoded images	Array
isCancelled	Flag tell picking cancelled	Boolean

Setup

• Setup iOS
• Setup Android

Cropping rules

Maximim aspect ratio:

• for landscape images - 1.5
• for portrait images - 1.2

Release new version

To release new npm package you need to:

1. Update package version in package.json
2. Run following script ./bin/new-release.sh "v1.0.1" "Publish empty release" (specify changes list and version)
3. Wait for Drone to publish npm package.