小程序文档整理之 -- API（媒体）

媒体

图片

wx.chooseImage(object)

从本地相册选择图片或使用相机拍照

wx.chooseImage({
  count: 1, // 最多可以选择的图片张数，默认9
  sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，original 原图，compressed 压缩图，默认二者都有
  sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，album 从相册选图，camera 使用相机，默认二者都有
  success: function (res) {
   // 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
    res={
        tempFilePaths,//图片的本地文件路径列表
        tempFiles:{
  //图片的本地文件列表，每一项是一个 File 对象
            path//本地文件路径
            size//本地文件大小，单位：B
        }
    }
  },
  fail: function (res){
   //接口调用失败的回调函数
  },
  complete: function (res){
   //接口调用结束的回调函数（调用成功、失败都会执行）
  }
})

注：文件的临时路径，在小程序本次启动期间可以正常使用，如需持久保存，需在主动调用 wx.saveFile，在小程序下次启动时才能访问得到。

wx.previewImage(object)

预览图片

wx.previewImage({
  current: '', // 当前显示图片的http链接,默认为 urls 的第一张
  urls: [] // 需要预览的图片http链接列表
  success: function (res) {
   //接口调用成功的回调函数
  },
  fail: function (res){
   //接口调用失败的回调函数
  },
  complete: function (res){
   //接口调用结束的回调函数（调用成功、失败都会执行）
  }
})

wx.getImageInfo(object)

获取图片信息

//从本地相册选择图片或使用相机拍照
wx.chooseImage({
  success: function (res) {
   
  //获取图片信息
    wx.getImageInfo({
      src: 'images/a.jpg',//图片的路径，可以是相对路径，临时文件路径，存储文件路径，网络图片路径
      success: function (res) {
   //接口调用成功的回调函数
          res.width;//图片宽度，单位px
          res.height;//图片高度，单位px
          res.path;//返回图片的本地路径
      },
      fail: function (res){
   //接口调用失败的回调函数
      },
      complete: function (res){
   //接口调用结束的回调函数（调用成功、失败都会执行）
      }
    })
  }
})

wx.saveImageToPhotosAlbum(object)

保存图片到系统相册。需要用户授权 scope.writePhotosAlbum

wx.saveImageToPhotosAlbum({
    filePath: 'images/a.jpg',//图片文件路径，可以是临时文件路径也可以是永久文