html5 调用系统api,HTML5+ API Reference

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

方法：

pick: 从系统相册选择文件(图片或视频)

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

对象：

GalleryOptions: JSON对象，从相册中选择文件的参数

PopPosition: JSON对象，弹出拍照或摄像界面指示位置

回调方法：

模块：

5+功能模块(permissions)

{

// ...

"permissions":{

// ...

"Gallery": {

"description": "系统相册"

}

}

}

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

void plus.gallery.pick( successCB, errorCB, option );

说明：

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

参数：

succesCB:

errorCB:

option:

返回值：

void

: 无

平台支持：

Android

- 2.2+

(支持):

返回的是系统相册路径，如“file:///storage/sdcard0/DCIM/Camera/1428841301674.jpg”。

iOS

- 5.1+

(支持):

受系统相册路径的访问限制，选择后图片会先拷贝到应用沙盒下的"_doc"目录中，如“file:///var/mobile/Applications/0373DFBF-6AA7-4C9B-AE1F-766469117C94/Library/Pandora/apps/HBuilder/doc/IMG_0005.jpg”。

示例：

Gallery Example

// 扩展API加载完毕后调用onPlusReady回调函数

document.addEventListener( "plusready", onPlusReady, false );

// 扩展API加载完毕，现在可以正常调用扩展API

function onPlusReady() {

}

// 从相册中选择图片

function galleryImg() {

// 从相册中选择图片

console.log("从相册中选择图片:");

plus.gallery.pick( function(path){

console.log(path);

}, function ( e ) {

console.log( "取消选择图片" );

}, {filter:"image"} );

}

// 从相册中选择多张图片

function galleryImgs(){

// 从相册中选择图片

console.log("从相册中选择多张图片:");

plus.gallery.pick( function(e){

for(var i in e.files){

console.log(e.files[i]);

}

}, function ( e ) {

console.log( "取消选择图片" );

},{filter:"image",multiple:true});

}

从相册中选择图片

选择单张图片

选择多张图片

保存文件到系统相册中

void plus.gallery.save( path, successCB, errorCB );

说明：

保存文件到系统相册中。

每次仅能保存一个文件，支持图片类型(jpg/jpeg、png、bmp等格式)和视频文件(3gp、mov等格式)。

若保存的文件系统不支持，则通过errorCB返回错误信息。

参数：

path :

(

String

)

必选要保存到系统相册中的文件文件地址

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

succesCB:

er