gallery


简介:

gallery模块管理系统相册,支持从相册中选择图片或视频文件、保存图片或视频文件到相册等功能。

方法:

  • pick : 从系统相册选择文件(图片或视频)。
  • save : 保存文件到系统相册中。

回调方法:

pick


从系统相册选择文件(图片和视频)。

rd.gallery.pick( GalleryPickSuccessCallback, GalleryErrorCallback, option);    
说明:

从系统相册中选择图片或视频文件,选择后将返回选择的文件路径。

参数:
  • option:(JSON) 必选 设置选择文件的参数
    • filter: (string ) 必选 相册中选择文件类型过滤器,可通过此参数设定相册选择器中可选择的文件类型,可设置仅可选择图片文 件或视频文件,默认值为仅可选择图片文件。可选内容见Filter
    • multiple: ( Boolen ) 必选 是否支持多选图片,为‘true’时表示可从系统相册中选择多张图片,选择图片后通过 GalleryMultiplePickSuccessCallback回调返回选择的图片,单选时通过GalleryPickSuccessCallback回调返回选择的图片。
  • Filter:相册选择文件过滤类型
    • image: ( String ) 仅可选择图片文件
    • video: ( String ) 仅可选择视频文件
    • none: ( String ) 不过滤,可选择图片或视频文件
  • GalleryPickSuccessCallback: 必选 从系统相册中选择文件完成后的回调函数
  • GalleryMultiplePickSuccessCallback:必选 从系统相册中选择文件完成后的回调函数
  • GalleryErrorCallback: 必选 从系统相册中选择文件操作错误的回调函数。
返回值:

示例:
var Option = {
    filter:"image",
    multiple:true
};
rd.gallery.pick(  
               GalleryPickSuccessCallback,
                GalleryErrorCallback,
                Option
            );

GalleryPickSuccessCallback


单选系统相册图片成功的回调。

function GalleryPickSuccessCallback(path){
     alert(path);
}

GalleryMultiplePickSuccessCallback


多选系统相册图片成功的回调。

function multiplePickCB(paths){
     alert(paths);
}

GalleryErrorCallback


系统相册操作失败的回调。

function GalleryErrorCallback(error){
     alert(error);
}  

save


保存图片或视频文件到系统相册中。

rd.gallery.save(path,GallerySuccessCallback,GalleryErrorCallback);
说明:

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

参数:
  • path: ( String ) 必选 要保存到系统相册中的文件文件地址。
  • GallerySuccessCallback: 必选 保存文件到系统相册中成功的回调函数
  • GalleryErrorCallback: 必选 保存文件到系统相册中失败的回调函数。
返回值:

示例:
rd.gallery.save(  
               "res://1.jpg",
               GallerySuccessCallback,
                GalleryErrorCallback
             ); 

GallerySuccessCallback


操作系统相册成功的回调。

function GallerySuccessCallback(info){
     alert(info);
}

GalleryErrorCallback


系统相册操作失败的回调。

function GalleryErrorCallback(error){
     alert(error);
}