微信小程序API 圖片

2020-07-28 15:24 更新

壓縮質(zhì)量,范圍0~100,數(shù)值越小,質(zhì)量越低,壓縮率越高(僅對jpg有效)。圖片路徑,圖片的路徑,支持本地路徑、代碼包路徑圖片路徑,圖片的路徑,支持本地路徑、代碼包路徑


wx.chooseImage(OBJECT)


從本地相冊選擇圖片或使用相機(jī)拍照。

OBJECT參數(shù)說明:

參數(shù) 類型 必填 說明
count Number 最多可以選擇的圖片張數(shù),默認(rèn)9
sizeType StringArray "original"原圖,"compressed"壓縮圖,默認(rèn)二者都有
sourceType StringArray "album"從相冊選圖,"camera"使用相機(jī),默認(rèn)二者都由
success Function 成功則返回圖片的本地文件路徑列表tempFilePaths
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

注:文件的臨時(shí)路徑,在小程序本次啟動(dòng)期間可以正常使用,如需持久保存,需在主動(dòng)調(diào)用 wx.saveFile,在小程序下次啟動(dòng)時(shí)才能訪問得到。

success返回參數(shù)說明:

參數(shù) 類型 說明 最低版本
tempFilePaths StringArray 圖片的本地文件路徑列表  
tempFiles ObjectArray 圖片的本地文件列表,每一項(xiàng)是一個(gè) File 對象 1.2.0

File 對象結(jié)構(gòu)如下:

字段 類型 說明
path String 本地文件路徑
size Number 本地文件大小,單位:B

示例代碼:

wx.chooseImage({
    count: 1, // 默認(rèn)9
    sizeType: ['original', 'compressed'], // 可以指定是原圖還是壓縮圖,默認(rèn)二者都有
    sourceType: ['album', 'camera'], // 可以指定來源是相冊還是相機(jī),默認(rèn)二者都有
    success: function (res) {
          // 返回選定照片的本地文件路徑列表,tempFilePath可以作為img標(biāo)簽的src屬性顯示圖片
        var tempFilePaths = res.tempFilePaths
    }
})

wx.previewImage(OBJECT)


? 預(yù)覽圖片。

OBJECT參數(shù)說明:

參數(shù) 類型 必填 說明
current String 當(dāng)前顯示圖片的鏈接,不填則默認(rèn)為urls的第一張
urls StringArray 需要預(yù)覽的圖片鏈接列表
success Function 接口調(diào)用成功的回調(diào)函數(shù)
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

示例代碼:

wx.previewImage({
    current: '', // 當(dāng)前顯示圖片的http鏈接
    urls: [] // 需要預(yù)覽的圖片http鏈接列表
})

wx.getImageInfo(OBJECT)

獲取圖片信息。

OBJECT參數(shù)說明:

參數(shù) 類型 必填 說明
src String 圖片的路徑,可以是相對路徑,臨時(shí)文件路徑,存儲(chǔ)文件路徑,網(wǎng)絡(luò)圖片路徑
success Function 接口調(diào)用成功的回調(diào)函數(shù)
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

success返回參數(shù)說明:

參數(shù) 類型 說明
width Number 圖片寬度,單位px
height Number 圖片高度 單位px
path String 返回圖片的本地路徑

示例代碼:

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

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


wx.saveImageToPhotosAlbum(OBJECT)


基礎(chǔ)庫 1.2.0 開始支持,低版本需做兼容處理

保存圖片到系統(tǒng)相冊,需要用戶授權(quán)(scope.writePhotosAlbum),詳見 用戶授權(quán)

OBJECT參數(shù)說明:

參數(shù)名 類型 必填 說明
filePath String 圖片文件路徑,可以是臨時(shí)文件路徑也可以是永久文件路徑,不支持網(wǎng)絡(luò)圖片路徑
success Function 接口調(diào)用成功的回調(diào)函數(shù)
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

success返回參數(shù)說明:

參數(shù)名 類型 說明
errMsg String 調(diào)用結(jié)果

示例代碼:

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

wx.compressImage(Object object)


基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

壓縮圖片接口,可選壓縮質(zhì)量

參數(shù)

Object參數(shù)說明:

 屬性  類型  默認(rèn)值  必填  說明
 src  string
是  圖片路徑,圖片的路徑,支持本地路徑、代碼包路徑
 quality  number 80 壓縮質(zhì)量,范圍0~100,數(shù)值越小,質(zhì)量越低,壓縮率越高(僅對jpg有效)。
 success  function   接口調(diào)用成功的回調(diào)函數(shù)
 fail  function   接口調(diào)用失敗的回調(diào)函數(shù)
 complete  function   接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

success返回參數(shù)說明:

屬性 類型 說明
tempFilePath string 壓縮后圖片的臨時(shí)文件路徑 (本地路徑)

示例代碼

wx.compressImage({
  src: '', // 圖片路徑
  quality: 80 // 壓縮質(zhì)量
})


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)