图像接口

注意: 微信上 chooseImage 接口用户点击"取消"不会触发任何回调。

chooseImage

拍照或从手机相册中选图接口


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
count number 选择图片数量,最多可选9张,默认9。
sourceType Array 可以指定来源是相册还是相机,默认二者都有。格式为:["album", "camera"],其中album为相册,camera为相机

额外参数
仅支持安卓平台

字段 类型 必填 说明
crop boolean 是否需要裁剪,默认 false
maxWidth number 裁剪后图片最大宽度,仅 crop 为 true 且 count = 1 时有效。
maxHeight number 裁剪后图片最大高度,仅 crop 为 true 且 count = 1 时有效。
quality number 压缩率,仅 crop 为 true 且 count = 1 时有效。

示例

mtl.chooseImage({
  count: 1,
  sourceType: ["album", "camera"],
  success: function(res) {
    // 返回选定照片的本地ID列表
    var localIds = res.localIds; // ['wxLocalResource://imageid123456789', ...]
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

previewImage

跳转到图片预览界面


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
current string 当前显示图片的 url
urls Array. 需要预览的图片 url 列表

示例

mtl.previewImage({
  current: "https://wx2.sinaimg.cn/mw690/70396e5agy1g0leayhrhoj211418gq9q.jpg",
  urls: [
    "https://wx3.sinaimg.cn/mw690/70396e5agy1g0leax4owvj211418gk2j.jpg",
    "https://wx4.sinaimg.cn/mw690/70396e5agy1g0leay2ymtj211418gk11.jpg",
    "https://wx2.sinaimg.cn/mw690/70396e5agy1g0leayhrhoj211418gq9q.jpg",
    "https://wx3.sinaimg.cn/mw690/70396e5agy1g0leazeikxj211418gqdc.jpg"
  ],
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

####


uploadImage

上传图片接口


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
localId string 需要上传的图片的本地ID
isShowProgressTips number 默认为1,显示加载框提示

示例

mtl.uploadImage({
  localId: "",
  isShowProgressTips: 1,
  success: function(res) {
    var serverId = res.serverId; // 返回图片的服务器端ID
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

downloadImage

下载图片接口


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
serverId string 需要下载的图片的服务器端ID
isShowProgressTips number 默认为1,显示加载框提示

示例

mtl.downloadImage({
  serverId: "",
  isShowProgressTips: 1,
  success: function(res) {
    var localId = res.localId; // 返回图片下载后的本地ID
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

getLocalImgSrc

获取本地图片 src 接口


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
localId string 图片的localID

示例

mtl.getLocalImgSrc({
  localId: "",
  success: function(res) {
    // 可以用 img 标签显示
    var src = res.imgSrc;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

getLocalImgData

获取本地图片 base64 接口


支持平台

微信 钉钉 友空间 原生 HTML5
✔︎ ✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
localId string 图片的localID

示例

mtl.getLocalImgData({
  localId: "",
  success: function(res) {
    var localData = res.localData; // localData是图片的base64数据,可以用 img 标签显示
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

####