跳到主要内容
版本:4.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)
}
})