@paralect/native-media-picker NPM

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
`bashowRoundAim`	Add round preset	Boolean	false
`saveState`	Save state of picker after dismissing	Boolean	false
`bashowFilters`	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

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:

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