Skip to main content
Version: 3.x

Taro.chooseMedia(option)

拍摄或从手机相册中选择图片或视频。

支持情况:

参考文档

类型

(option: Option) => Promise<SuccessCallbackResult>

参数

参数类型
optionOption

Option

参数类型默认值必填说明
countnumber9最多可以选择的文件个数
API 支持度: weapp, h5
mediaType(keyof mediaType)[]['image', 'video']文件类型
API 支持度: weapp, h5
sourceType(keyof sourceType)[]['album', 'camera']图片和视频选择的来源
API 支持度: weapp, h5
maxDurationnumber10拍摄视频最长拍摄时间,单位秒。时间范围为 3s 至 60s 之间
API 支持度: weapp
sizeType("original" or "compressed")[]['original', 'compressed']是否压缩所选文件
API 支持度: weapp
camerastring"back"仅在 sourceType 为 camera 时生效,使用前置或后置摄像头
API 支持度: weapp, h5
complete(res: TaroGeneral.CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: TaroGeneral.CallbackResult) => void接口调用失败的回调函数
success(result: SuccessCallbackResult) => void接口调用成功的回调函数
mediaIdstring用来上传的input元素ID
API 支持度: h5

SuccessCallbackResult

参数类型说明
tempFilesChooseMedia[]本地临时文件列表
typestring文件类型,有效值有 image 、video、mix

ChooseMedia

本地临时文件列表

参数类型必填说明
tempFilePathstring本地临时文件路径 (本地路径)
sizenumber本地临时文件大小,单位 B
durationnumber视频的时间长度
heightnumber视频的高度
widthnumber视频的宽度
thumbTempFilePathstring视频缩略图临时文件路径
fileTypestring选择的文件的类型
originalFileObjFile原始的浏览器 File 对象
API 支持度: h5

mediaType

参数说明
video只能拍摄视频或从相册选择视频
image只能拍摄图片或从相册选择图片
mix可同时选择图片和视频

sourceType

参数说明
album从相册选择
camera使用相机拍摄

camera

参数说明
back使用后置摄像头
front使用前置摄像头

示例代码

Taro.chooseMedia({
count: 9,
mediaType: ['image','video'],
sourceType: ['album', 'camera'],
maxDuration: 30,
camera: 'back',
success: (res) => {
console.log(res.tempFiles)
console.log(res.type)
}
})