该 API 使用方法为 wx.chooseImage(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 | - | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
属性 | 类型 | 说明 |
tempFilePaths | Array.<string> | 图片的本地临时文件路径列表 (本地路径) |
tempFiles | Array.<Object> | 图片的本地临时文件列表 |
属性 | 类型 | 说明 |
path | string | 本地临时文件路径 |
size | number | 本地临时文件大小，单位 B |
wx.chooseImage({count: 1,sizeType: ['original', 'compressed'],sourceType: ['album', 'camera'],success (res) {// tempFilePath可以作为 img 标签的 src 属性显示图片const tempFilePaths = res.tempFilePaths}})
该 API 使用方法为 wx.compressImage(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
src | string | - | 是 | 图片的路径，支持本地路径、代码包路径 |
quality | number | 80 | 否 | 压缩质量，范围0～100，数值越小，质量越低，压缩率越高（仅对 jpg 有效） |
compressedWidth | number | - | 否 | 压缩后图片的宽度，单位为 px，若不填写则默认以 compressedHeight 为准等比缩放 |
compressedHeight | number | - | 否 | 压缩后图片的高度，单位为 px，若不填写则默认以 compressedWidth 为准等比缩放 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
属性 | 类型 | 说明 |
tempFilePath | string | 压缩后图片的临时文件路径 (本地路径) |
wx.compressImage({src: '', // 图片路径quality: 80 // 压缩质量})
该 API 使用方法为 wx.getImageInfo(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
src | string | - | 是 | 图片的路径，可以是相对路径、临时文件路径、存储文件路径、网络图片路径 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
属性 | 类型 | 说明 |
width | number | 图片原始宽度，单位 px。不考虑旋转 |
height | number | 图片原始高度，单位 px。不考虑旋转 |
path | string | 图片的本地路径 |
orientation | string | 拍照时设备方向 |
type | string | 图片格式 |
值 | 说明 |
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 |
合法值 | 说明 |
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)},})},})
该 API 使用方法为 wx.previewImage(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
urls | Array.<string> | - | 是 | 需要预览的图片链接列表。 支持云文件 ID |
current | string | 第一个 url | 否 | 当前显示图片的链接 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.previewImage({current: '', // 当前显示图片的 http 链接urls: [], // 需要预览的图片 http 链接列表})
该 API 使用方法为 wx.previewMedia(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
sources | Array.<Object> | | 是 | 需要预览的资源列表 |
current | number | 0 | 否 | 当前显示的资源序号 |
success | function | | 否 | 接口调用成功的回调函数 |
fail | function | | 否 | 接口调用失败的回调函数 |
complete | function | | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
该 API 使用方法为 wx.saveImageToPhotosAlbum(Object object)
属性 | 类型 | 默认值 | 必填 | 说明 |
filePath | string | - | 是 | 图片文件路径，可以是临时文件路径或永久文件路径 (本地路径)，不支持网络图片路径 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.saveImageToPhotosAlbum({success(res) {},})
该 API 使用方法为 wx.chooseMessageFile(Object object)
属性 | 类型 | 合法值及说明 | 默认值 | 必填 | 说明 |
count | number | - | - | 是 | 最多可以选择的文件个数，可以 0～100 |
type | string | all：从所有文件选择 video：只能选择视频文件 image：只能选择图片文件 file：可以选择除了图片和视频之外的其它的文件 | 'all' | 否 | 所选的文件的类型 |
extension | Array.<string> | - | - | 否 | 根据文件拓展名过滤，仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。 |
success | function | - | - | 否 | 接口调用成功的回调函数 |
fail | function | - | - | 否 | 接口调用失败的回调函数 |
complete | function | - | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
该 API 使用方法为 wx.chooseExternalFile(Object object)
属性 | 类型 | 合法值及说明 | 默认值 | 必填 | 说明 |
count | number | - | - | 是 | 最多可以选择的文件个数，可以 0～100 |
type | string | all：从所有文件选择 video：只能选择视频文件 image：只能选择图片文件 file：可以选择除了图片和视频之外的其它的文件 | 'all' | 否 | 所选的文件的类型 |
extension | Array.<string> | - | - | 否 | 根据文件拓展名过滤，仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。 |
success | function | - | - | 否 | 接口调用成功的回调函数 |
fail | function | - | - | 否 | 接口调用失败的回调函数 |
complete | function | - | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
文档反馈