Gallery模块管理系统相册，支持从相册中选择图片或视频文件、保存图片或视频文件到相册等功能。通过plus.gallery获取相册管理对象。

权限

5+功能模块(permissions)

方法：

void plus.gallery.pick( successCB, errorCB, option );功能：从系统相册选择文件(图片或视频)

说明：从系统相册中选择图片或视频文件。每次仅能选择一个文件，选择后将返回选择的文件路径。

参数：

succesCB: ( GalleryPickSuccessCallback | GalleryMultiplePickSuccessCallback ) 必选 从系统相册中选择文件完成后的回调函数

单选时通过GalleryPickSuccessCallback回调函数返回选择的图片或视频文件路径，多选时通过GalleryMultiplePickSuccessCallback回调函数返回图片或视频文件路径。

errorCB: ( GalleryErrorCallback ) 可选 从系统相册中选择文件操作错误的回调函数

option: ( GalleryOptions ) 可选 设置选择文件的参数

参数详情

animation: (Boolean 类型 )是否显示系统相册文件选择界面的动画，可取值true、false，默认值为true。

filename: (String 类型 )选择文件保存的路径，某些系统不能直接使用系统相册的路径，

这时需要将选择的文件保存到应用可访问的目录中，可通过此参数设置保存文件的路径。

如果路径中包括文件后缀名称，则表明指定文件路径及名称，否则仅指定文件保存目录，文件名称自动生成。

平台支持

Android - 2.2+ (不支持): 直接返回系统相册中的文件路径，忽略此参数。

iOS - 4.3+ (支持): iOS会将相册中的文件拷贝到当前应用沙箱系统目录中，

如果未设置则默认使用“_doc”目录。

filter: (GalleryFilter 类型 )相册中选择文件类型过滤器

系统相册选择器中可选择的文件类型，可设置为仅选择图片文件(“image”)、

视频文件(“video”)或所有文件(“none”)，默认值为“image”。

save: 保存文件到系统相册中

maximum: (Number 类型 )最多选择的图片数量

仅在支持多选时有效，取值范围为1到Infinity，默认值为Infinity，即不限制选择的图片数。

如果设置的值非法则使用默认值Infinity。

代码演示

//单文件选择

function pickFile(){

plus.gallery.pick(

function(path){mui.toast(path);},

function(e){mui.toast(e);}

);

}

//多文件选择

function pickFile(){

plus.gallery.pick(

function(paths){for(i in paths.files){mui.toast(paths.files[i]);}},

function(e){mui.toast('取消了选择');},

{multiple:true,maximum:5}

);

}

void plus.gallery.save( path, successCB, errorCB );保存文件到系统相册中

说明：保存文件到系统相册中。 每次仅能保存一个文件，支持图片类型(jpg/jpeg、png、bmp等格式)和视频文件(3gp、mov等格式)。 若保存的文件系统不支持，则通过errorCB返回错误信息。

参数：

path : ( String ) 必选 要保存到系统相册中的文件文件地址

仅支持本地路径，不支持网络路径。

succesCB: ( GallerySuccessCallback ) 必选 保存文件到系统相册中成功的回调函数

errorCB: ( GalleryErrorCallback ) 可选 保存文件到系统相册中失败的回调函数

演示代码

function pickFile(){

plus.gallery.pick(

function(path){

plus.gallery.save( path, function(){

mui.toast('ok');

}, function(){

mui.toast('失败');

});

},

function(e){mui.toast('取消了选择');}

)