# uni.chooseMedia(options)

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

# chooseMedia 兼容性

Web 微信小程序 Android iOS
x 4.41 4.51 4.51

# 参数

名称 类型 必填 默认值 兼容性 描述
options ChooseMediaOptions - - -
名称 类型 必备 默认值 兼容性 描述
pageOrientation string -
屏幕方向。默认为page.json中的pageOrientation。
合法值 兼容性 描述
auto - 自动
portrait - 竖屏显示
landscape - 横屏显示
count number 9
最多可以选择的文件个数
mediaType Array<string> ['image', 'video']
album 从相册选视频,camera 使用相机拍摄,合法值:'image'、'video'、'mix'
sourceType Array<string> ['album', 'camera']
album 从相册选视频,camera 使用相机拍摄
maxDuration number 10
拍摄视频最长拍摄时间,单位秒。时间范围为 3s 至 30s 之间
camera string -
仅在 sourceType 为 camera 时生效,使用前置或后置摄像头
合法值 兼容性 描述
front - 前置摄像头
back - 后置摄像头
success (callback: ChooseMediaSuccess) => void -
接口调用成功,返回视频文件的临时文件路径,详见返回参数说明
fail (callback: IChooseMediaError) => void -
接口调用失败的回调函数
complete (callback: any) => void -
接口调用结束的回调函数(调用成功、失败都会执行)
sizeType Array<string> -
是否压缩所选文件,基础库2.25.0前仅对 mediaType 为 image 时有效,2.25.0及以后对全量 mediaType 有效

# ChooseMediaSuccess 的属性值

名称 类型 必备 默认值 兼容性 描述
tempFiles Array<ChooseMediaTempFile> - - -
名称 类型 必备 默认值 兼容性 描述
tempFilePath string - - 选定视频的临时文件路径
fileType string - - 文件类型
合法值 兼容性 描述
image - -
video - -
size number - - 选定视频的数据量大小
duration number - - 选定视频的时间长度
height number - - 返回选定视频的长
width number - - 返回选定视频的宽
thumbTempFilePath string - - 视频缩略图临时文件路径
type string - - -
合法值 兼容性 描述
image - -
video - -
mix - -

# IChooseMediaError 的属性值

名称 类型 必备 默认值 兼容性 描述
errCode number - - 错误码
合法值 兼容性 描述
1101001 - 用户取消
1101005 - 未获取权限
1101006 - 图片或视频保存失败
1101008 - 拍照或录像失败
errSubject string - - 统一错误主题(模块)名称
data any - - 错误信息中包含的数据
cause Error - - 源错误信息,可以包含多个错误,详见SourceError
errMsg string - - -

# 参见

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 兼容性 描述
errMsg string -
错误信息

# Tips