圖片
chooseImage
TIP
該API使用方法為: wx.chooseImage(Object object)
功能說明: 從本地相册選擇圖片或使用相機拍照。
參數及說明: Object object
内容 類型 合法值及說明 預設值 必填 說明 count number - 9 否 多可以選擇的圖片張數 sizeType Array.< string>original:原圖
compressed:壓縮圖['original', 'compressed'] 否 所選的圖片的尺寸 sourceType Array.< string>album:原圖
camera:壓縮圖['album', 'camera'] 否 選擇圖片的來源 success Function - - 否 接口調用成功的回呼函數 fail Function - - 否 接口調用失敗的回呼函數 complete Function - - 否 接口調用結束的回呼函數(無論成功與否都執行) object.success回呼函數參數: Object res。
内容 類型 說明 tempFilePaths Array.< string>圖片的本地暫存文件路徑清單(本地路徑) tempFiles Array.< Object>圖片的本地暫存文件清單 res.tempFiles的結構
内容 類型 說明 path string 本地暫存文件路徑 size number 本地暫存文件大小,單位B 示例代碼:
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
内容 類型 預設值 必填 說明 src string - 是 圖片路徑,支持網絡圖片、臨時路徑、代碼包路徑 quality number 80 否 壓縮質量,範圍0~100,數值越小,質量越低,壓縮率越高(僅對jpg有效) compressedWidth number - 否 壓縮後圖片的寬度,單位為px,若不填寫則默認以compressedHeight為准等比縮放 compressedHeight number - 否 壓縮後圖片的高度,單位為px,若不填寫則默認以compressedWidth為准等比縮放 success Function - 否 接口調用成功的回呼函數 fail Function - 否 接口調用失敗的回呼函數 complete Function - 否 接口調用結束的回呼函數(無論成功與否都執行) object.success回呼函數參數: Object res。
内容 類型 說明 tempFilePath string 壓縮後圖片的暫存文件路徑(本地路徑) 示例代碼:
wx.compressImage({
src: '', // Image path
quality: 80 // Compression quality
})getImageInfo
TIP
該API使用方法為: wx.getImageInfo(Object object)
該API小程序支持,小遊戲暫不支持
功能說明: 獲取圖片資訊,網絡圖片需先配置download功能變量名稱才能生效
參數及說明: Object object
内容 類型 預設值 必填 說明 src string - 是 圖片的路徑,可以是相對路徑、暫存文件路徑、存儲文件路徑、網絡圖片路徑 success Function - 否 接口調用成功的回呼函數 fail Function - 否 接口調用失敗的回呼函數 complete Function - 否 接口調用結束的回呼函數(無論成功與否都執行) object.success回呼函數參數: Object res。
内容 類型 說明 width number 圖片原始寬度,單位 px,不考慮旋轉 height number 圖片原始高度,單位 px,不考慮旋轉 path string 圖片的本地路徑 orientation string 拍照時設備方向 type string 圖片格式 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 未知格式 jpeg jpeg壓縮格式 png png壓縮格式 gif gif壓縮格式 tiff tiff壓縮格式 示例代碼:
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
内容 類型 預設值 必填 說明 urls Array.< string>- 是 需要預覽的圖片連結清單。 支持雲文件ID current string urls的第一張 否 當前顯示圖片的連結 success Function - 否 接口調用成功的回呼函數 fail Function - 否 接口調用失敗的回呼函數 complete Function - 否 接口調用結束的回呼函數(無論成功與否都執行) 示例代碼:
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
内容 類型 預設值 必填 說明 sources Array.< Object>- 是 需要預覽的資源清單 current number 0 否 當前顯示的資源序號 success Function - 否 接口調用成功的回呼函數 fail Function - 否 接口調用失敗的回呼函數 complete Function - 否 接口調用結束的回呼函數(無論成功與否都執行)
saveImageToPhotosAlbum
TIP
該API使用方法為: wx.saveImageToPhotosAlbum(Object object)
該API小程序支持,小遊戲暫不支持
TIP
調用前需要'用戶授權'scope.writePhotosAlbum
功能說明: 保存圖片到系統相册。
參數及說明: Object object
内容 類型 預設值 必填 說明 filePath string - 是 圖片文件路徑,可以是暫存文件路徑或永久文件路徑(本地路徑),不支持網絡圖片路徑 success Function - 否 接口調用成功的回呼函數 fail Function - 否 接口調用失敗的回呼函數 complete Function - 否 接口調用結束的回呼函數(無論成功與否都執行) 示例代碼:
wx.saveImageToPhotosAlbum({
success(res) {},
})