开发
API

tt.chooseMedia

基础库 2.41.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

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

语法

tt.chooseMedia(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
countnumber9最多可以选择的文件个数,不能超过 20。(超过会自动设置为 20)2.41.0
mediaTypestring[]['image', 'video']支持的媒体类型2.41.0
sourceTypestring[]['album', 'camera']图片和视频选择的来源2.41.0
maxDurationnumber10录制视频的最大时长,单位秒。时间范围为 3s 至 60s 之间(传入时间范围不符合规范则设置为默认值)。从相册选择的视频无时长限制。2.41.0
sizeTypestring[]仅对 mediaType 为 image 时有效,是否压缩所选文件,默认压缩2.41.0
camerastring'back'仅在 sourceType 为 camera 时生效,'front' 使用前置摄像头,'back' 使用后置摄像头,Android 暂不支持拉起前置摄像头2.41.0
successfunction接口调用成功的回调函数2.41.0
failfunction接口调用失败的回调函数2.41.0
completefunction接口调用结束的回调函数(调用成功、失败都会执行)2.41.0

mediaType 的合法值

说明最低支持版本
['image']只能拍摄图片或从相册选择图片2.41.0
['video']只能录制视频或从相册选择视频2.41.0
['image', 'video']支持图片或视频2.41.0

sourceType 的合法值

说明最低支持版本
['album']从相册选择2.41.0
['camera']使用相机拍摄2.41.0
['album', 'camera']从相册选择或使用相机拍摄2.41.0

sizeType 的合法值

说明最低支持版本
['original']原图2.41.0
['compressed']压缩系数 0.75 的图片2.41.0

camera 的合法值

说明最低支持版本
'front'使用前置摄像头2.41.0
'back'使用后置摄像头2.41.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"chooseMedia:ok"2.41.0
tempFilesTempFile[]本地临时文件列表2.41.0

TempFile 类型说明

object 类型,属性如下:

属性名类型说明最低支持版本
tempFilePathstring本地临时文件路径 (本地路径)2.41.0
sizenumber本地临时文件大小,单位 B2.41.0
mediaTypestring媒体类型。(image/video)2.41.0
durationnumber视频的时间长度(文件类型是视频时才返回)2.41.0
heightnumber视频的高度(文件类型是视频时才返回,视频太短无法返回)2.41.0
widthnumber视频的宽度(文件类型是视频时才返回,视频太短无法返回)2.41.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"chooseMedia:fail" + 详细错误信息2.41.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.chooseMedia({
  count: 9,
  mediaType: ["image", "video"],
  sourceType: ["album", "camera"],
  sizeType: ["original"],
  maxDuration: 30,
  camera: "back",
  success(res) {
    console.log(res.tempFiles.tempFilePath);
    console.log(res.tempFiles.size);
  },
});

Bug & Tip

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助