tt.chooseImage
基础库 1.0.0 开始支持本方法。
从系统相册中选择图片,或使用相机拍摄图片。
该 API 需要用户授权方可调用,详细信息可参考用户授权。
参数
Object 类型,属性如下:
属性 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
sourceType | Array<string> | ['album', 'camera'] | 否 | 指定图片来源为相册或/和相机 | 1.0.0 |
count | number | 9 | 否 | 最多可以选择的图片数量,拍照时此选项无效 | 1.0.0 |
success | function | 否 | 接口调用成功的回调函数 | 1.0.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 1.0.0 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 1.0.0 |
success 返回参数说明
Object 类型,属性如下:
属性 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
tempFilePaths | Array<string> | 图片地址数组 | 1.0.0 |
tempFiles | Array<object> | 图片对象数组 | 1.0.0 |
tempFiles 数组中对象结构如下:
属性 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
path | string | 本地文件路径 | 1.0.0 |
size | number | 本地文件大小(单位:B) | 1.0.0 |
代码示例
tt.chooseImage({
sourceType: ["album"],
count: 3,
success(res) {
this.setData({
images: res.tempFilePaths
});
},
fail(res) {
console.log(`chooseImage调用失败`);
}
});
Bug & Tip
- Tip:iOS 暂不支持同时从album和camera中选择,只能二者其一,当都传时使用album。
- Tip:暂不支持sizeType参数。