图片

my.chooseImage

拍照或从手机相册中选择图片。扫码体验:

img.jpg

入参

名称类型必填描述
countNumber最大可选照片数,默认1张
sizeTypeStringArrayoriginal 原图,compressed 压缩图,默认二者都有
sourceTypeString Array相册选取或者拍照,默认 [‘camera’,‘album’]
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称类型描述
apFilePathsString Array图片文件描述

错误码描述

error描述
11用户取消操作

代码示例

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

my.previewImage

暂不支持本地图片路径

预览图片。

入参

名称类型必填描述
urlsArray要预览的图片链接列表
currentNumber当前显示图片索引,默认 0
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

代码示例

  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. });
  • 基础库版本 1.0.0 在 iOS 上暂时不支持 my.previewImagemy.chooseImage 的组合使用。

my.saveImage

保存在线图片到手机相册。

入参

名称类型必填描述
urlString要保存的图片链接
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

错误码描述

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

代码示例

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

my.compressImage

基础库版本 1.4.0 开始支持,低版本需做兼容处理

压缩图片。扫码体验:

img.jpg

入参

名称类型必填描述
apFilePathsString Array要压缩的图片地址数组
compressLevelNumber压缩级别,支持 0 ~ 4 的整数,默认 4。详见「compressLevel表 说明表」
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称类型描述
apFilePathsString 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 开始支持,低版本需做兼容处理

获取图片信息。扫码体验:

img.jpg

入参


名称

类型

必填

描述

src

String



图片路径,目前支持:

-
网络图片路径

-
apFilePath路径

-
相对路径

success

Function



调用成功的回调函数

fail

Function



调用失败的回调函数

complete

Function



调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称类型描述
widthNumber图片宽度(单位px)
heightNumber图片高度(单位px)
pathString图片本地路径
orientationString返回图片的方向,有效值见下表
typeString返回图片的格式

orientation参数说明:

枚举值说明
up默认
down180度旋转
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. })

原文: https://docs.alipay.com/mini/api/media-image