Skip to content

sandlz/ImageSave

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ImageSave

Save images to album for cordova plugin.It's best using with ion-img-cache. 中文版请参考使用说明

Support platforms

  • IOS (>=8.0)
  • Android (>=4.4)

Features

  • Custom album
  • Online image、Local image

Usage

Code

Code State Message
100 Success All success
101 Success Part success && Part failed
110 Error All failed
120 Error Permission denied
130 Error Other exception(Android)

Call

Params

{
    // image data
    imageList: imageList,
    // custom album name
    albumName: albumName,
    // cache dir name
    cacheDirName: cacheDirName
}

Example:

var imageList = [
    {
        fileFullName: 'xxx.png',
        cacheFileName:'ab112ssq.png',
        imageUrl: 'http://xxx.png'
    }
];
var cacheDirName = 'cacheDir';
var albumName = 'Custom Album';

if (window.plugins && window.plugins.ImageSave) {
    window.plugins.ImageSave.saveToAlbum(JSON.stringify({
        imageList: imageList,
        albumName: albumName,
        cacheDirName: cacheDirName
        }), function (data) {
            // Success
        }, function (error) {
            // Error
        });
} else {
    console.log("Please intall the plugin.");
}

Callback

Success

function (data) {
    // data : {code: 100, message: 'xxxx'}
}

Error

function (error) {
    // error : {code: 120, message: 'xxxx'}
}

IOS

In view of the above IOS8 market has reached more than 95%, the lowest version of 8, the use of 8 after the new Photos.framework. Offical data

When the user manually sets the settings to close the album access rights, you need to manually open the album switch

- (void)openSetting {
    NSURL *url = [NSURL URLWithString:UIApplicationOpenSettingsURLString];
    if ([[UIApplication sharedApplication] canOpenURL:url]) {
        [[UIApplication sharedApplication] openURL:url];
    }
}

CacheDir

Our project using imgcachejs ion-image-cache,Please check it's document.

/application dir/Library/files/cacheDir/

Android

CacheDir

/External Path/cacheDir/

Issues

IOS

If image url contains chinese words, FileTransfer may throw an error,

File Transfer Error: Invalid server URL 'xxxxxx'

How to fix it?

Before 'NSURL* sourceURL = [NSURL URLWithString:source];'
Add below line
(ios 7 later)
source = [source stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];

TODO

  • Android - Fit 6.0
  • IOS - Handle repeat image

Contact

Commitissues or Mail 978949438@qq.com