普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持

tt.addAudioTrack 异步

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

调用本方法可为本地视频添加额外的音轨。

语法

tt.addAudioTrack(options);

参数说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
videoPathstring要混合的视频路径2.16.0
audipParamsArray[AudioParam]要混合的音频属性,支持大部分音频格式和 mp42.16.0
successFunction混合成功的回调2.16.0
failFunction混合失败的回调2.16.0

AudioParam 对象属性如下:

属性名类型默认值必填说明最低支持版本
audioPathstring要混合的音频路径2.16.0
audioRange[start:number,end:number]要混合的音频自身的入点,出点,即选择哪一段音频进行混合 (单位为毫秒)2.16.0
videoRange[start:number,end:number]要混合的视频自身的入点,出点,即要往哪一段视频混合(单位为毫秒) ,建议 audioRange 与 videoRange 保持一致2.16.0

回调成功

object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring回调信息(此处为 ok)2.16.0
videoPathstring混合后的视频路径2.16.0
videoDurationnumber视频时长2.16.0

回调失败

object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring回调信息(失败原因等)2.16.0

扫码体验

暂无

代码示例

let systemInfo = tt.getSystemInfoSync();
let canvas = tt.createCanvas(),
  ctx = canvas.getContext("2d");

let recoerderVideoPath;

function mixAudioTrack() {
  const task = tt.addAudioTrack({
    videoPath: recoerderVideoPath, // 录屏后文件的路径
    audioParams: [
      {
        audioPath: "ttfile://user//xx.MP3", // 这里填音频的路径
        audioRange: [0, 10000], // 音乐自身的入点,出点,可以填视频的duration
        videoRange: [0, 10000], // 视频自身的入点,出点。这里表示将音频的前10s,与视频的前10s进行混合。
      },
    ],
    success(res) {
      tt.showModal({
        title: "混合成功",
        content: JSON.stringify(res),
      });
      tt.shareAppMessage({
        channel: "video",
        extra: {
          videoPath: res.videoPath,
        },
        success() {
          tt.showModal({
            title: "分享成功",
          });
        },
        fail(e) {
          tt.showModal({
            title: "分享失败",
          });
        },
      });
    },
    fail(res) {
      tt.showModal({
        title: "混合失败",
        content: JSON.stringify(res),
      });
    },
  });
  task.onProgressUpdate((res) => {
    console.log("progress: " + res.progress);
    tt.showToast({
      title: JSON.stringify(res.progress),
    });
  });
}

tt.onTouchEnd((res) => {
  const recorder = tt.getGameRecorderManager();

  recorder.onStop((res) => {
    console.log(res.videoPath);
    recoerderVideoPath = res.videoPath;
    mixAudioTrack();
  });

  recorder.start();
  setTimeout(() => {
    recorder.stop();
  }, 15000);
});

function draw() {}

draw();

Bug & Tip

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