图片
my.chooseImage
拍照或从手机相册中选择图片。扫码体验:
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
count | Number | 否 | 最大可选照片数,默认1张 |
sizeType | StringArray | 否 | original 原图,compressed 压缩图,默认二者都有 |
sourceType | String Array | 否 | 相册选取或者拍照,默认 [‘camera’,‘album’] |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 返回值
名称 | 类型 | 描述 |
---|---|---|
apFilePaths | String Array | 图片文件描述 |
错误码描述
error | 描述 |
---|---|
11 | 用户取消操作 |
代码示例
my.chooseImage({
count: 2,
success: (res) => {
img.src = res.apFilePaths[0];
},
});
my.previewImage
暂不支持本地图片路径
预览图片。
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
urls | Array | 是 | 要预览的图片链接列表 |
current | Number | 否 | 当前显示图片索引,默认 0 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
代码示例
my.previewImage({
current: 2,
urls: [
'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg',
'https://img.alicdn.com/tps/TB1pfG4IFXXXXc6XXXXXXXXXXXX.jpg',
'https://img.alicdn.com/tps/TB1h9xxIFXXXXbKXXXXXXXXXXXX.jpg'
],
});
- 基础库版本
1.0.0
在 iOS 上暂时不支持my.previewImage
和my.chooseImage
的组合使用。
my.saveImage
保存在线图片到手机相册。
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
url | String | 是 | 要保存的图片链接 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
错误码描述
error | 描述 |
---|---|
2 | 参数无效,没有传 url 参数 |
15 | 没有开启相册权限(ios only) |
16 | 手机相册存储空间不足(ios only) |
17 | 保存图片过程中的其他错误 |
代码示例
my.saveImage({url:'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg'});
my.compressImage
基础库版本 1.4.0 开始支持,低版本需做兼容处理
压缩图片。扫码体验:
入参
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
apFilePaths | String Array | 是 | 要压缩的图片地址数组 |
compressLevel | Number | 否 | 压缩级别,支持 0 ~ 4 的整数,默认 4。详见「compressLevel表 说明表」 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 返回值
名称 | 类型 | 描述 |
---|---|---|
apFilePaths | String Array | 压缩后的路径数组 |
compressLevel表
compressLevel | 说明 |
---|---|
0 | 低质量 |
1 | 中等质量 |
2 | 高质量 |
3 | 不压缩 |
4 | 根据网络适应 |
代码示例
my.compressImage({
apFilePaths:['https://resource/apmlcc0ed184daffc5a0d8da86b2f518cf7b.image'],
compressLevel:1,
success:(res)=>{
console.log(JSON.stringify(res))
}
})
my.getImageInfo
基础库版本 1.4.0 开始支持,低版本需做兼容处理
获取图片信息。扫码体验:
入参
名称 | 类型 | 必填 | 描述 |
src | String | 否 | 图片路径,目前支持: - 网络图片路径 - apFilePath路径 - 相对路径 |
success | Function | 否 | 调用成功的回调函数 |
fail | Function | 否 | 调用失败的回调函数 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 返回值
名称 | 类型 | 描述 |
---|---|---|
width | Number | 图片宽度(单位px) |
height | Number | 图片高度(单位px) |
path | String | 图片本地路径 |
orientation | String | 返回图片的方向,有效值见下表 |
type | String | 返回图片的格式 |
orientation参数说明:
枚举值 | 说明 |
---|---|
up | 默认 |
down | 180度旋转 |
left | 逆时针旋转90度 |
right | 顺时针旋转90度 |
up-mirrored | 同up,但水平翻转 |
down-mirrored | 同down,但水平翻转 |
left-mirrored | 同left,但垂直翻转 |
right-mirrored | 同right,但垂直翻转 |
代码示例
//网络图片路径
my.getImageInfo({
src:'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg',
success:(res)=>{
console.log(JSON.stringify(res))
}
})
//apFilePath
my.chooseImage({
success: (res) => {
my.getImageInfo({
src:res.apFilePaths[0],
success:(res)=>{
console.log(JSON.stringify(res))
}
})
},
})
//相对路径
my.getImageInfo({
src:'image/api.png',
success:(res)=>{
console.log(JSON.stringify(res))
}
})