抖音开放平台Logo
控制台

tt.mergeVideo

更新时间 2024-08-15 03:23:06
收藏
我的收藏

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

将视频进行合并。

前提条件
业务背景
使用限制
注意事项
相关教程

语法

tt.mergeVideo(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
videoPathsarray
视频的文件路径,支持ttfile和相对路径;至少2个元素,按照顺序合并
2.58.0
successfunction
接口调用成功的回调函数
2.58.0
failfunction
接口调用失败的回调函数
2.58.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
2.58.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
videoDurationnumber
合并后的视频时长,单位毫秒
2.58.0
videoPathstring
合并后的视频ttfile路径
2.58.0
errMsgstring
"mergeVideo:ok"
2.58.0

回调失败

object 类型,属性如下:

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

返回值

返回值为 object 类型,详细参数描述如下:

属性名类型说明最低支持版本
onProgressUpdatefunction
进度更新回调函数, 入参类型是 { progress: number },表示合并操作的进度
2.58.0

代码示例

let shareParam = {
  videoPath: "",
};

let task = tt.mergeVideo({
  videoPaths: [videoPath1, videoPath2],
  success(res) {
    tt.showModal({
      title: "合并成功",
      content: JSON.stringify(res),
    });
    shareParam.videoPath = res.videoPath;
  },
  fail(res) {
    tt.showModal({
      title: "合并失败",
      content: JSON.stringify(res),
    });
  },
});

task.onProgressUpdate((res) => {
  console.log("progress: " + res.progress);
  tt.showToast({
    title: JSON.stringify(res.progress),
  });
});