Gallery模块管理系统相册,支持从相册中选择图片或视频文件、保存图片或视频文件到相册等功能。通过plus.gallery获取相册管理对象。
permissions
"Gallery": { "description": "访问系统相册" }
JSON对象,从相册中选择文件的参数
从系统相册中选择文件的保存路径,如果路径中包括文件后缀名称,则表明指定文件路径及名称,否则仅指定文件保存目录,文件名称由程序自动生成。
可通过此参数设定相册选择器中可选择的文件类型,可设置仅可选择图片文件或视频文件,默认值为仅可选择图片文件。
可从系统相册中选择多张图片,选择图片后通过GalleryMultiplePickSuccessCallback回调返回选择的图片。
是否显示系统相册文件选择界面的动画,可取值true、false,默认值为true。
对于大屏幕设备如iPad,相册选择界面为弹出窗口,此时可通过此参数设置弹出窗口位置。 其为JSON对象,格式如{top:"10",left:10,width:200,height:200},所有值为像素值,左上坐标相对于容器的位置,默认弹出位置为屏幕居中。
相册选择文件过滤类型
JSON对象,弹出拍照或摄像界面指示位置
弹出拍照或摄像窗口指示区域距离容器顶部的距离,单位支持像素值(如100px)和百分比(如50%),如不写单位则为像素值值。
弹出拍照或摄像窗口指示区域距离容器左侧的距离,单位支持像素值(如100px)和百分比(如50%),如不写单位则为像素值。
弹出拍照或摄像窗口指示区域的宽度,单位支持像素值(如100px)和百分比(如50%),如不写单位则为像素值。
弹出拍照或摄像窗口指示区域的高度,单位支持像素值(如100px)和百分比(如50%),如不写单位则为像素值。
单选系统相册图片成功的回调
void onSuccess( file ) { // Success code }
系统相册中单选图片或视频文件成功的回调函数,在选择文件操作成功时调用。
多选系统相册图片成功的回调
void onSuccess( event ) { // event.files 保存多选的图片或视频文件路径 }
系统相册中多选图片或视频文件成功的回调函数,在多选择文件操作成功时调用。
操作系统相册成功的回调
void onSuccess() { // Success code }
系统相册操作成功的回调函数,在保存文件到系统相册操作成功时调用。
无
系统相册操作失败的回调
void onError( error ) { // Error code. }
系统相册操作失败的回调函数,在选择或保存图片操作失败时调用。