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('取消了选择');}
);
}