wx.chooseMedia
wx.chooseMedia(Object object)
基础库 2.10.0 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:支持
小程序插件:支持,需要小程序基础库版本不低于 2.11.1
微信 Windows 版:支持
微信 Mac 版:支持
微信 鸿蒙 OS 版:支持
功能描述
拍摄或从手机相册中选择图片或视频。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 | |
|---|---|---|---|---|---|
| count | number | 9 | 否 | 最多可以选择的文件个数,基础库2.25.0前,最多可支持9个文件,2.25.0及以后最多可支持20个文件 | |
| mediaType | Array. |
['image', 'video'] | 否 | 文件类型 | |
| 合法值说明image只能拍摄图片或从相册选择图片video只能拍摄视频或从相册选择视频mix可同时选择图片和视频 | |||||
| sourceType | Array. |
['album', 'camera'] | 否 | 图片和视频选择的来源 | |
| 合法值说明album从相册选择camera使用相机拍摄 | |||||
| maxDuration | number | 10 | 否 | 拍摄视频最长拍摄时间,单位秒。时间范围为 3s 至 60s 之间。不限制相册。 | |
| sizeType | Array. |
['original', 'compressed'] | 否 | 是否压缩所选文件,基础库2.25.0前仅对 mediaType 为 image 时有效,2.25.0及以后对全量 mediaType 有效 | |
| camera | string | 'back' | 否 | 仅在 sourceType 为 camera 时生效,使用前置或后置摄像头 | |
| 合法值说明back使用后置摄像头front使用前置摄像头 | |||||
| success | function | 否 | 接口调用成功的回调函数 | ||
| fail | function | 否 | 接口调用失败的回调函数 | ||
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.success 回调函数
参数
Object res
| 属性 | 类型 | 说明 | |
|---|---|---|---|
| tempFiles | Array. | 本地临时文件列表 | |
| 结构属性类型说明tempFilePathstring本地临时文件路径 (本地路径)sizenumber本地临时文件大小,单位 Bdurationnumber视频的时间长度heightnumber视频的高度widthnumber视频的宽度thumbTempFilePathstring视频缩略图临时文件路径fileTypestring文件类型合法值说明image图片video视频 | |||
| type | string | 文件类型,有效值有 image 、video、mix |
示例代码
wx.chooseMedia({
count: 9,
mediaType: ['image','video'],
sourceType: ['album', 'camera'],
maxDuration: 30,
camera: 'back',
success(res) {
console.log(res.tempFiles[0].tempFilePath)
console.log(res.tempFiles[0].size)
}
})
浙公网安备 33010602011771号