Skip to content

圖片

chooseImage

TIP

該API使用方法為: wx.chooseImage(Object object)

  • 功能說明: 從本地相册選擇圖片或使用相機拍照。

  • 參數及說明: Object object

    内容類型合法值及說明預設值必填說明
    countnumber-9多可以選擇的圖片張數
    sizeTypeArray.<string>original:原圖
    compressed:壓縮圖
    ['original', 'compressed']所選的圖片的尺寸
    sourceTypeArray.<string>album:原圖
    camera:壓縮圖
    ['album', 'camera']選擇圖片的來源
    successFunction--接口調用成功的回呼函數
    failFunction--接口調用失敗的回呼函數
    completeFunction--接口調用結束的回呼函數(無論成功與否都執行)
  • object.success回呼函數參數: Object res。

    内容類型說明
    tempFilePathsArray.<string>圖片的本地暫存文件路徑清單(本地路徑)
    tempFilesArray.<Object>圖片的本地暫存文件清單
  • res.tempFiles的結構

    内容類型說明
    pathstring本地暫存文件路徑
    sizenumber本地暫存文件大小,單位B
  • 示例代碼:

js
wx.chooseImage({
  count: 1,
  sizeType: ['original', 'compressed'],
  sourceType: ['album', 'camera'],
  success(res) {
    // tempFilePath can be used as the src attribute in an img tag to display the image
    const tempFilePaths = res.tempFilePaths
  }
})

compressImage

TIP

該API使用方法為: wx.compressImage(Object object)
該API小程序支持,小遊戲暫不支持

  • 功能說明: 壓縮圖片接口,可選壓縮質量。

  • 參數及說明: Object object

    内容類型預設值必填說明
    srcstring-圖片路徑,支持網絡圖片、臨時路徑、代碼包路徑
    qualitynumber80壓縮質量,範圍0~100,數值越小,質量越低,壓縮率越高(僅對jpg有效)
    compressedWidthnumber-壓縮後圖片的寬度,單位為px,若不填寫則默認以compressedHeight為准等比縮放
    compressedHeightnumber-壓縮後圖片的高度,單位為px,若不填寫則默認以compressedWidth為准等比縮放
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • object.success回呼函數參數: Object res。

    内容類型說明
    tempFilePathstring壓縮後圖片的暫存文件路徑(本地路徑)
  • 示例代碼:

js
wx.compressImage({
  src: '', // Image path
  quality: 80 // Compression quality
})

getImageInfo

TIP

該API使用方法為: wx.getImageInfo(Object object)
該API小程序支持,小遊戲暫不支持

  • 功能說明: 獲取圖片資訊,網絡圖片需先配置download功能變量名稱才能生效

  • 參數及說明: Object object

    内容類型預設值必填說明
    srcstring-圖片的路徑,可以是相對路徑、暫存文件路徑、存儲文件路徑、網絡圖片路徑
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • object.success回呼函數參數: Object res。

    内容類型說明
    widthnumber圖片原始寬度,單位 px,不考慮旋轉
    heightnumber圖片原始高度,單位 px,不考慮旋轉
    pathstring圖片的本地路徑
    orientationstring拍照時設備方向
    typestring圖片格式
  • res.orientation合法值

    說明
    up默認方向(手機橫持拍照),對應Exif中的1,或無orientation資訊
    up-mirrored同up,但鏡像翻轉,對應Exif中的2
    down旋轉180度,對應Exif中的3
    down-mirrored同down,但鏡像翻轉,對應Exif中的4
    left-mirrored同left,但鏡像翻轉,對應Exif中的5
    right順時針旋轉90度,對應Exif中的6
    right-mirrored同right,但鏡像翻轉,對應Exif中的7
    left逆時針旋轉90度,對應Exif中的8
  • res.type合法值

    說明
    unknown未知格式
    jpegjpeg壓縮格式
    pngpng壓縮格式
    gifgif壓縮格式
    tifftiff壓縮格式
  • 示例代碼:

js
wx.getImageInfo({
  src: 'images/a.jpg',
  success(res) {
    console.log(res.width)
    console.log(res.height)
  },
})

wx.chooseImage({
  success(res) {
    wx.getImageInfo({
      src: res.tempFilePaths[0],
      success(res) {
        console.log(res.width)
        console.log(res.height)
      },
    })
  },
})

previewImage

TIP

該API使用方法為: wx.previewImage(Object object)
該API小程序支持,小遊戲暫不支持

  • 功能說明: 在新頁面中全屏預覽圖片。 預覽的過程中用戶可以進行保存圖片、發送給朋友等操作。

  • 參數及說明: Object object

    内容類型預設值必填說明
    urlsArray.<string>-需要預覽的圖片連結清單。 支持雲文件ID
    currentstringurls的第一張當前顯示圖片的連結
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • 示例代碼:

js
wx.previewImage({
  current: '', // The HTTP link to the currently displayed image.
  urls: [], // List of HTTP image links to be previewed.
})

previewMedia

TIP

該API使用方法為: wx.previewMedia(Object object)
該API小程序支持,小遊戲暫不支持

  • 功能說明: 預覽圖片和視頻。

  • 參數及說明: Object object

    内容類型預設值必填說明
    sourcesArray.<Object>-需要預覽的資源清單
    currentnumber0當前顯示的資源序號
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)

saveImageToPhotosAlbum

TIP

該API使用方法為: wx.saveImageToPhotosAlbum(Object object)
該API小程序支持,小遊戲暫不支持

TIP

調用前需要'用戶授權'scope.writePhotosAlbum

  • 功能說明: 保存圖片到系統相册。

  • 參數及說明: Object object

    内容類型預設值必填說明
    filePathstring-圖片文件路徑,可以是暫存文件路徑或永久文件路徑(本地路徑),不支持網絡圖片路徑
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • 示例代碼:

js
wx.saveImageToPhotosAlbum({
  success(res) {},
})