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
无
