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

将视频进行合并。

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

语法

tt.mergeVideo(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
videoPaths	Array<string>	是	视频的文件路径，支持ttfile和相对路径；至少2个元素，按照顺序合并	2.58.0
success	function	否	接口调用成功的回调函数	2.58.0
fail	function	否	接口调用失败的回调函数	2.58.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	2.58.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
videoDuration	number	合并后的视频时长，单位毫秒	2.58.0
videoPath	string	合并后的视频ttfile路径	2.58.0
errMsg	string	"mergeVideo:ok"	2.58.0

回调失败

object 类型，属性如下：

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

返回值

返回值为 object 类型，详细参数描述如下：

属性名	类型	说明	最低支持版本
onProgressUpdate	function	进度更新回调函数，入参类型是 { 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),
  });
});