抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 基础
  • 渲染
  • 媒体
  • 图片
  • tt.chooseImage
  • tt.saveImageToPhotosAlbum
  • tt.previewImage
  • tt.getImageInfo
  • tt.compressImage
  • 音频
  • Canvas 录制
  • 数据缓存
  • TTML
  • 数据分析
  • 页面导航
  • 设备
  • 画布
  • 界面
  • 直播开放能力
  • tt.getImageInfo
    收藏
    我的收藏

    基础库 3.41.0 开始支持本方法,这是一个异步方法。
    获取图片信息。
    前提条件
    无
    业务背景
    无
    使用限制
    无
    注意事项
    无
    支持沙盒
    否
    相关教程
    无

    语法

    tt.getImageInfo(options)

    参数说明

    options 为 object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    src
    string
    ​
    是
    图片路径,可以是相对路径、临时文件路径或存储文件路径,如果是网络图片请参考获取网络图片信息,可通过 tt.chooseImage 获取相册或相机拍摄的图片路径
    3.41.0
    success
    function
    ​
    否
    接口调用成功的回调函数
    3.41.0
    fail
    function
    ​
    否
    接口调用失败的回调函数
    3.41.0
    complete
    function
    ​
    否
    接口调用结束的回调函数(调用成功、失败都会执行)
    3.41.0

    回调成功

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    path
    string
    返回图片的本地路径,若为网络图片则该 API 首先会下载图片再返回下载到本地后的临时路径
    3.41.0
    type
    string
    图片格式
    3.41.0
    width
    number
    图片宽度,单位 px
    3.41.0
    height
    number
    图片高度,单位 px
    3.41.0
    orientation
    enum
    拍照时设备方向,合法值参考 orientation 的合法值。orientation 的介绍请参考链接
    3.41.0
    errMsg
    string
    "getImageInfo:ok"
    3.41.0
    ​

    orientation 的合法值

    值
    说明
    最低支持版本
    right
    顺时针旋转 90 度,对应 Exif 中的 6
    3.41.0
    left
    逆时针旋转 90 度,对应 Exif 中的 8
    3.41.0
    up
    默认方向(手机横持拍照),对应 Exif 中的 1。或无 orientation 信息。
    3.41.0
    up-mirrored
    同 up,但镜像翻转,对应 Exif 中的 2
    3.41.0
    down
    旋转 180 度,对应 Exif 中的 3
    3.41.0
    down-mirrored
    同 down,但镜像翻转,对应 Exif 中的 4
    3.41.0
    left-mirrored
    同 left,但镜像翻转,对应 Exif 中的 5
    3.41.0
    right-mirrored
    同 right,但镜像翻转,对应 Exif 中的 7
    3.41.0

    回调失败

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    errMsg
    string
    "getImageInfo:fail " + 详细错误信息
    3.41.0

    错误码

    errorCode
    errMsg
    errorType
    说明
    最低支持版本
    110499
    params src is require
    D
    src 数组为空
    3.41.0
    110404
    sandbox is nil
    F
    小程序框架内部错误,有需要请拉客服咨询
    3.41.0
    110403
    permission denied, read {filePath}
    D
    传入了非法路径
    3.41.0
    110401
    no such file or directory {filePath}
    D
    传入了不存在的路径
    3.41.0
    110402
    decode image fail
    D
    传入的路径非图片
    3.41.0
    110491
    Internal error: Failed to get image info.internal error
    F
    小程序框架内部错误,有需要请拉客服咨询
    3.41.0
    110405
    download image fail
    U
    图片下载失败
    3.41.0

    扫码体验

    ​
    请使用字节宿主APP扫码

    代码示例

    <!-- index.ttml --> <image src="{{image}}" mode="widthFix" bindtap="previewImage"></image> <button type="primary" bindtap="getImageInfo">获取上面的图片信息</button> <view>图片信息:{{imageInfo}}</view>
    // index.js Page({ data: { image: "https://s3.pstatp.com/toutiao/static/img/logo.201f80d.png", imageInfo: "", }, getImageInfo() { tt.getImageInfo({ src: this.data.image, // 也可以为本地路径,相对路径或临时文件路径 success: (res) => { tt.showToast({ title: "获取成功" }); let { type, width, height, path } = res; let imageInfo = `图片类型: ${type}; 图片宽度: ${width}px; 图片高度: ${height}px; 图片路径: ${path}`; this.setData({ imageInfo, }); }, fail: (err) => { tt.showModal({ title: "获取失败", content: err.errMsg, showCancel: false, }); }, complete() { console.log("获取完成"); }, }); }, });

    获取网络图片信息

    如果要获取网络图片的信息,需要预先在开发者平台配置 download 的域名白名单。具体步骤为:开发者平台 -> 选择目标小程序 -> 开发设置 -> 服务器域名 -> downloadFile 合法域名。
    ​
    ​
    ​
    ​
    ​
    ​
    ​