https://github.com/collaborne/cordova-gallery-access

Reads photos & videos from an album (e.g. Camera Roll) and returns them as dataURLs
https://github.com/collaborne/cordova-gallery-access

Last synced: about 2 months ago
JSON representation

Reads photos & videos from an album (e.g. Camera Roll) and returns them as dataURLs

• Host: GitHub
• URL: https://github.com/collaborne/cordova-gallery-access
• Owner: Collaborne
• License: mit
• Created: 2017-01-07T10:39:27.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2019-08-10T21:27:24.000Z (over 5 years ago)
• Last Synced: 2024-10-30T17:44:06.279Z (about 2 months ago)
• Language: TypeScript
• Homepage:
• Size: 37.1 KB
• Stars: 15
• Watchers: 6
• Forks: 8
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cordova-gallery-access [![Build Status](https://travis-ci.org/Collaborne/cordova-gallery-access.svg)](https://travis-ci.org/Collaborne/cordova-gallery-access)

Reads photos & videos from an album (e.g. Camera Roll)

Tested for iOS and Android. Likely works also for other platforms (but not tested).

This [blog post](https://medium.com/collaborne-engineering/my-cordova-nightmares-accessing-photos-from-the-phones-gallery-7528a0860555#.jq0oqswb8) explains the challenges that this library addresses and the approach how it solves them.

The module can automatically check if the user granted the required permission.

For Android 6 permission checks this requires to add [cordova-plugin-android-permission](https://github.com/NeoLSN/cordova-plugin-android-permission) to the Cordova application.

## Install

~~~~

npm install cordova-gallery-access --save

~~~~

The library uses the Cordova plugin [cordova-gallery-api](https://github.com/Collaborne/cordova-gallery-api.git),

which you therefore need to install to your Cordova application:

```bash

cordova plugin add https://github.com/Collaborne/cordova-gallery-api.git --save --nofetch

```

## Usage

This examples shows the recently taken photos from the Camera Roll:

```javascript

import * as cordovaGallery from 'cordova-gallery-access';

cordovaGallery.load().then(items => {

    let html = '';

    items.forEach(item => {

        html += ``;

    });

    document.getElementById("content").innerHTML = html;

}).catch(e => console.error(e));

```

The `load` method supports optional parameters:

```javascript

cordovaGallery.load({

    albumType: 'PHAssetCollectionSubtypeSmartAlbumUserLibrary',

    count: 10

});

```

Supported options:

| Option        | Description                                          |

| ------------- | ---------------------------------------------------- |

| **albumType** | Type of the album from which the items will be taken |

| **count**     | Maximal number of items that will be returned        |