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

    基础库 3.41.0 开始支持本方法,这是一个异步方法。
    压缩图片接口,可选压缩质量,并可以产出压缩后的图片到本地临时文件。仅对 jpg 格式图片有效。

    语法

    tt.compressImage(options)

    参数说明

    options 为 object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    src
    string | string[]
    ​
    是
    图片路径,详情见 src 说明
    3.41.0
    quality
    number
    80
    否
    压缩质量,范围 0 ~ 100,数值越小,质量越低,压缩率越高
    3.41.0
    success
    function
    ​
    否
    接口调用成功后的回调函数
    3.41.0
    fail
    function
    ​
    否
    接口调用失败后的回调函数
    3.41.0
    complete
    function
    ​
    否
    接口调用结束后的回调函数(调用成功、失败都会执行)
    3.41.0

    src 说明

    src 可以是本地路径、代码包相对路径,但不支持网络图片。基础库 3.41.0 版本之后,支持传入路径数组,批量压缩图片。当批量压缩时:
      1.如果批量压缩全部失败,会进入 fail 回调。
      2.如果批量压缩部分压缩成功、部分压缩失败,则会进入 success 回调,压缩失败的图片返回空字符串。

    回调成功

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    errMsg
    string
    "compressImage:ok"
    3.41.0
    tempFilePath
    string | string[]
    压缩完成后的文件的临时路径
    3.41.0

    回调失败

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

    扫码体验

    代码示例

    <!-- index.ttml --> <view class="wrap"> <button type="primary" bindtap="compressImage">点击选择图片压缩</button> <view>压缩前:</view> <image class="image" src="{{oldSrc}}"></image> <view>压缩后:</view> <image class="image" src="{{newSrc}}"></image> </view>
    // index.js Page({ data: { oldSrc: "", newSrc: "", }, compressImage() { tt.chooseImage({ success: (res) => { this.setData({ oldSrc: res.tempFilePaths[0], }); tt.compressImage({ src: res.tempFilePaths[0], quality: 80, success: (res) => { tt.showToast({ title: "压缩成功" }); this.setData({ newSrc: res.tempFilePath, }); }, fail: (err) => { tt.showModal({ title: "压缩失败", content: err.errMsg, showCancel: false, }); }, complete: (res) => { console.log("压缩完成"); }, }); }, fail: (err) => { tt.showModal({ title: "选择图片失败", content: err.errMsg, showCancel: false, }); }, }); }, });

    Bug & Tip

    无