开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
跳转
多媒体
图片
旧版接口(停止更新)
视频
音频
录音
lottie 动画
相机
缓存
文件
位置
网络
设备
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 多媒体 > 图片 > my.getimageinfo
评论
收藏
我的文档
设置

my.getimageinfo(object object)

基础库  或更高版本; 且 支付宝客户端 10.1.8 或更高版本; 若版本较低,建议采取 兼容处理

支小宝客户端 支持

安诊儿客户端 支持

主体: 企业支付宝小程序个人支付宝小程序

获取图片信息。

object object

查看示例

属性 类型 默认值 必填 描述
src string -

图片路径,支持网络地址、本地临时文件本地缓存文件本地用户文件代码包文件
注意:

  • 访问代码包文件路径,需要在 mini.project.json 文件中增加一些配置,具体可见示例代码。
  • 客户端 10.2.70 、ide 3.8.0 开始支持本地用户文件。
success function -

调用成功的回调函数

fail function -

调用失败的回调函数

complete function -

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

success 回调函数

参数

object res

查看示例

属性 类型 兼容性 描述
width number -

图片宽度,单位为 px

height number -

图片高度,单位为 px

path string -

图片的 本地临时文件 路径

orientation string
基础库: 1.10.0/2.3.1

返回图片的方向

枚举值 描述 兼容性
up

默认方向,对应 中的 1

-
up-mirrored

同 up,但镜像翻转,对应 exif 中的 2

-
down

旋转 180 度,对应 exif 中的 3

-
down-mirrored

同 down,但镜像翻转,对应 exif 中的 4

-
left-mirrored

同 left,但镜像翻转,对应 exif 中的 5

-
right

顺时针旋转 90 度,对应 exif 中的 6

-
right-mirrored

同 right,但镜像翻转,对应 exif 中的 7

-
left

逆时针旋转 90 度,对应 exif 中的 8

-
type string
基础库: 1.10.0/2.3.1

返回图片的格式

枚举值 描述 兼容性
png

png 格式

-
jpeg

jpeg 格式。支付宝客户端 10.5.36 版本之前,安卓为 jpg

-
gif

gif 格式

-
webp

webp 格式

-
hevc

hevc 格式

-
bmp

bmp 格式

-
heic

heic 格式

-

fail 回调的参数为 object,error 属性为错误码,errormessage 属性为错误消息。

错误码 错误消息 凯发app官方网站的解决方案
12(android)2(ios) 接口参数无效。

检查 src 路径格式是否正确。

12(ios) 文件不存在。

检查 src 路径是否有特殊字符或者缺少协议名称,例如有空格等等。

18(android) 获取图片信息失败。

检查 src 链接是否真实有效存在。

"21 " 下载文件失败。

检查 src 链接是否真实有效存在。

代码示例
扫码体验
my.getimageinfo(object object)
读取代码包文件
检测文件真实类型
success 回调参数
fail 回调参数
my.getimageinfo ({
  src: 'https://img.alicdn.com/tps/tb1sxgyifxxxxc5xpxxxxxxxxxx.jpg',
  success: function (res) {
    console.log (res);
  },
  fail: function (err) {
    console.log (err);
  },
});
mini.project.json
读取包文件
// mini.project.json 配置示例,下例中 source 为根目录(app.json 所在目录)下的文件夹,* 代表任意文件名。
{
  "assetsinclude": ["image/*.jpg"]
}
my.getimageinfo ({
  // 包文件路径与当前页面路径无关。/source/api.png 也可写作 source/api.png,含义相同,都是从项目根目录算起
  src: '/source/api.png',
  success: function (res) {
    console.log (res);
  },
  fail: function (err) {
    console.log (err);
  },
});
my.getimageinfo ({
  src: 'https://img.alicdn.com/tps/tb1sxgyifxxxxc5xpxxxxxxxxxx.jpg',
  success: function (res) {
    console.log ('getimageinfo: success', res);
    my.detectfiletype ({
      filepath: res.path,
      success (res) {
        console.log ('detectfiletype: success', res);
      },
      fail (err) {
        console.log ('detectfiletype: fail', err);
      },
    });
  },
  fail: function (err) {
    console.log ('getimageinfo: fail', err);
  },
});
{
  "height": 121,
  "orientation": "up",
  "path": "https://resource/67fb0515088f92ffba8e5a0df259b491.image",
  "type": "png",
  "width": 312
}
{
  "error": 2,
  "errormessage": "接口参数无效"
}
  • tip
    读取小程序 代码包文件 前需在 mini.project.json 中配置可读取的小程序文件。
  • tip
    ios 端判断图片类型需选择原图,否则无法正确判断出 gif 格式的图片。
  • tip

    最终得到的图片路径在 ide 上以实际后缀名为后缀(部分不常用的图片后缀名会以 .null 为后缀),在真机预览上以 .image 为后缀。

    若需判断文件扩展真实后缀名,可使用 my.detectfiletype 进行查询,请以此接口返回结果为准,不过需注意此接口仅限真机调试,可参考上方示例代码。

  • bug
    支付宝客户端 10.5.36 版本之前,对于 jpg 图片,安卓端回调参数 type 的值为 jpg,ios 为 jpeg;10.5.36 以及之后版本,type 值均为 jpeg。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图