全部产品
云市场

图片

更新时间:2019-09-09 15:18:30

my.chooseImage

说明:mPaaS 10.1.32 及以上版本支持该接口。

拍照或从手机相册中选择图片。

入参

名称 类型 必填 描述
count Number 最大可选照片数,默认为 1 张
sizeType StringArray original 原图,compressed 压缩图,默认二者都有
sourceType String Array 相册选取或者拍照,默认为 [‘camera’,‘album’]
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称 类型 描述
apFilePaths String Array 图片文件描述

错误码

error 描述
11 用户取消操作

代码示例

  1. my.chooseImage({
  2. count: 2,
  3. success: (res) => {
  4. img.src = res.apFilePaths[0];
  5. },
  6. });

my.previewImage

说明:mPaaS 10.1.32 及以上版本支持该接口。

此接口用于预览图片。暂不支持浏览本地图片。

入参

名称 类型 必填 描述
urls Array 要预览的图片链接列表
current Number 当前显示图片索引,默认为 0
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

  1. my.previewImage({
  2. current: 2,
  3. urls: [
  4. 'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg',
  5. 'https://img.alicdn.com/tps/TB1pfG4IFXXXXc6XXXXXXXXXXXX.jpg',
  6. 'https://img.alicdn.com/tps/TB1h9xxIFXXXXbKXXXXXXXXXXXX.jpg'
  7. ],
  8. });

my.saveImage

说明:mPaaS 10.1.32 及以上版本支持该接口。

此接口用于将在线图片保存至手机相册。

入参

名称 类型 必填 描述
url String 要保存的图片链接
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

错误码

error 描述
2 参数无效,没有传 url 参数
15 没有开启相册权限(iOS only)
16 手机相册存储空间不足(iOS only)
17 保存图片过程中的其他错误

代码示例

  1. my.saveImage({url:'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg'});

my.compressImage

说明:基础库 1.14.1 及以上版本支持该接口,低版本需做兼容处理,操作参见 小程序基础库说明,mPaaS 10.1.60 及以上版本支持该接口。

此接口用于压缩图片。

入参

名称 类型 必填 描述
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 根据网络适应

代码示例

  1. my.compressImage({
  2. apFilePaths:['https://resource/apmlcc0ed184daffc5a0d8da86b2f518cf7b.image'],
  3. compressLevel:1,
  4. success:(res)=>{
  5. console.log(JSON.stringify(res))
  6. }
  7. })

my.getImageInfo

说明:基础库 1.4.0 及以上版本支持本接口,低版本需做兼容处理,操作参见 小程序基础库说明,mPaaS 10.1.32 及以上版本支持该接口。

此接口用于获取图片信息。

入参

名称
类型
必填
描述
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,但垂直翻转

代码示例

  1. //网络图片路径
  2. my.getImageInfo({
  3. src:'https://img.alicdn.com/tps/TB1sXGYIFXXXXc5XpXXXXXXXXXX.jpg',
  4. success:(res)=>{
  5. console.log(JSON.stringify(res))
  6. }
  7. })
  8. //apFilePath
  9. my.chooseImage({
  10. success: (res) => {
  11. my.getImageInfo({
  12. src:res.apFilePaths[0],
  13. success:(res)=>{
  14. console.log(JSON.stringify(res))
  15. }
  16. })
  17. },
  18. })
  19. //相对路径
  20. my.getImageInfo({
  21. src:'image/api.png',
  22. success:(res)=>{
  23. console.log(JSON.stringify(res))
  24. }
  25. })