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.