图片
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);
}
});