图片

swan.chooseImage()

从本地相册选择图片或使用相机拍照。

swan.chooseImage(opts)

参数值:

属性 类型 是否必填 描述
count Number 最多可以选择的图片张数,默认 9
sizeType Array.<string> original 原图,compressed 压缩图,默认二者都有
sourceType Array.<string> album 从相册选图,camera 使用相机,默认二者都有
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用完成的回调函数(接口成功、失败都会执行)

object.sizeType 的有效值:

描述
['original'] 原图
['compressed'] 压缩图
['original', 'compressed'] 原图和压缩图都有

object.sourceType 的有效值:

描述
['album'] 从相册选图
['camera'] 使用相机拍照
['album', 'camera'] 可从本地相册选择图片或使用相机拍照

返回值:

success 回调函数:

形如 function (res) {...},其中:

属性 类型 描述
res.tempFilePath Array.<string> 图片的本地文件路径列表
res.tempFiles Array.<Object> 图片的本地文件列表,每一项是一个 File 对象

tempFiles 对象结构:

字段 类型 描述
tempFiles.path string 本地文件路径
tempFiles.size number 本地文件大小(单位:B)

示例:

swan.chooseImage({
    count: 1,
    sizeType: ['original', 'compressed'],
    sourceType: ['album', 'camera'],
    success: res => {
        console.log(res.tempFilePaths);
        console.log(res.tempFiles);
    },
    fail: function () {
        console.log('接口调用失败');
    }
});

swan.previewImage()

预览图片。

swan.previewImage(opts)

参数值:

属性 类型 是否必填 描述
current string 当前显示图片的链接,不填则默认为 urls 的第一张
urls Array.<string> 需要预览的图片链接列表
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用完成的回调函数(接口成功、失败都会执行)

示例:

const current = 'https://lvyou.baidu.com/static/qianfan/lvyou/kingkong/pics/aaa.png';
const urls = [
    'https://www.baidu.com/img/superlogo_c4d7df0a003d3db9b65e9ef0fe6da1ec.png',
    'https://lvyou.baidu.com/static/qianfan/lvyou/kingkong/pics/aaa.png',
    'https://www.baidu.com/img/bd_logo1.png'
];
swan.previewImage({
    current,
    urls,
    success: res => {
        console.log('接口执行成功');
    },
    fail: function () {
        console.log('接口执行失败');
    },
    complete: function () {
        console.log('接口执行完成');
    }
});

注意:

暂不支持预览本地文件。

swan.saveImageToPhotosAlbum()

基础库 swan-game.js 1.5.2 版本开始支持。

保存图片到系统相册,需要用户授权。

swan.saveImageToPhotosAlbum(opts)

opts 对象属性说明

属性 类型 默认值 是否必填 描述
opts Object - 调用该方法时,要传入的对象参数
opts.filePath string - 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径
opts.success function - 接口调用成功的回调函数
opts.fail function - 接口调用失败的回调函数
opts.complete function - 接口调用完成的回调函数(接口成功、失败都会执行)

示例:

swan.saveImageToPhotosAlbum({
    filePath: '/xxx/xxx.jpg',
    success: res => {
        console.log(res);
    },
    fail: err => {
        console.log('错误码:' + err.errCode);
        console.log('错误信息:' + err.errMsg);
    }
});