抖音开放平台Logo
控制台

tt.chooseVideo
收藏
我的收藏

基础库 1.0.0 开始支持本方法，这是一个异步方法。

从系统相册中选择视频，或使用相机拍摄视频，返回视频的临时文件路径。

前提条件

该 API 需要用户授权方可调用，详细信息可参考用户授权。

业务背景无
使用限制无
注意事项
  • 手动取消也会触发失败回调，回调参数为 chooseVideo:fail cancel，可以通过判断详细错误信息区分取消和其他错误。
  • iOS 无论 compressed 传入 true 或者 false, 都会压缩处理。
  • 安卓无论 compressed 传入 true 或者 false, 都不会压缩。
相关教程无

语法

tt.chooseVideo(options)

参数说明

options 为 object 类型，属性如下：

属性名类型默认值必填说明最低支持版本
sourceTypeArray<string>["album", "camera"]否

指定视频来源为相册(album)或相机(camera) ，默认两者都有

1.0.0
camerastring"back"否

'front' 使用前置摄像头，'back' 使用后置摄像头，默认拉起的是后置摄像头。Android 暂不支持拉起前置摄像头

1.0.0
compressedbooleantrue否

是否需要压缩视频源文件，默认值为 true，需要压缩

1.0.0
maxDurationnumber60否

选择视频的最大时长（单位：s），取值范围(0, 180]，maxDuration <= 0 时取值 60, maxDuration > 180 时取值 180，在取值范围内为传入值

1.0.0
successfunction否
接口调用成功的回调函数
1.0.0
failfunction否
接口调用失败的回调函数
1.0.0
completefunction否
接口调用结束的回调函数（调用成功、失败都会执行）
1.0.0

回调成功

object 类型，属性如下：

属性名类型说明最低支持版本
widthnumber

选定视频的视频宽度（单位：px）

1.0.0
heightnumber

选定视频的高度（单位：px）

1.0.0
tempFilePathstring

选定视频的临时文件路径

1.0.0
durationnumber

选定视频的时间长度 (单位：s)

1.0.0
sizenumber

选定视频的数据量大小（单位：B）

1.0.0
errMsgstring
"chooseVideo:ok"
1.0.0

回调失败

object 类型，属性如下：

属性名类型说明最低支持版本
errMsgstring

"chooseVideo:fail" + 详细错误信息。
回调失败的触发时机有：取消选择、参数错误、没有授权/授权失败、视频时长超过 60 秒、文件路径为空、文件路径不存在。

1.0.0

代码示例

tt.chooseVideo({
  sourceType: ["album", "camera"],
  compressed: true,
  success: (res) => {
    let { duration, width, height, size } = res;
    this.setData({
      videoSrc: res.tempFilePath,
      description: `视频时长：${duration}s; 视频宽度：${width}px; 视频高度：${height}px; 视频大小：${size}B`,
    });
  },
  fail: (err) => {
    let errType = err.errMsg.includes("chooseVideo:fail cancel")
      ? "取消选择"
      : "选择失败";
    tt.showModal({
      title: errType,
      content: err.errMsg,
      showCancel: false,
    });
  },
  complete: (res) => {
    console.log("完成选择");
  },
});