帮你快速理解、总结文档立即下载

Android

最近更新时间:2026-11-09 14:52:03
我的收藏

功能概览

录制支持边录边播的背景音乐:录制过程中按设定速度播放,音乐信息会记录进每个录制片段(TAVRecordSegment.bgmPath 与 bgmStartPosition),便于后续编辑阶段对齐。BGM 能力由 ITAVBGMManager 提供,通过 TAVRecorder.getBGMManager() 获取。

相关接口类

接口类名
描述
ITAVBGMManager
设置、定位、循环、音量与清除 BGM。
TAVRecordSegment
片段模型,记录该段使用的 BGM 与起始位置。

接口方法

方法
说明
void setBGM(String path, float speed)
设置背景音乐。speed 为播放器初始速度,建议固定传 1.0f;录制开始后 BGM 速度会按录制速度自动换算,此处设置不会保留。
void seekTo(long position)
跳转到指定位置播放;position 单位微秒。
void setLoop(boolean loop)
是否循环。
void setVolume(float volume)
音量。
void clearBGM()
清除背景音乐。

设置与播放控制

ITAVBGMManager bgmManager = recorder.getBGMManager();

// 设置 BGM(speed 固定传 1.0f,实际播放速度由录制速度决定)
bgmManager.setBGM(context.getFilesDir() + "/bgm/demo.mp3", 1.0f);

// 从 30 秒处开始播放(单位:微秒)
bgmManager.seekTo(30_000_000L);

// 循环播放、调整音量
bgmManager.setLoop(true);
bgmManager.setVolume(0.8f);

// 无需BGM时清理
bgmManager.clearBGM();

片段中的 BGM 信息

BGM 仅在录制期间外放,不会混入片段文件:片段的音轨只包含麦克风声音(startRecord 的 enableMic 为 false 时为静音)。SDK 会把当前 BGM 的信息记录到片段中,进入编辑阶段后需由业务侧使用这些信息把 BGM 重新添加到时间线,例如调用 TAVEditor.addBgm(...)。
字段
说明
TAVRecordSegment.bgmPath
该段使用的 BGM 路径;未设置 BGM 时为 null。
TAVRecordSegment.bgmStartPosition
该段开始时 BGM 的播放位置(微秒),由停止录制时的播放位置减去片段时长推算。
因此“多段录制 + 中途换 BGM”时,各段会保留各自的信息。
分段之间 BGM 默认连续播放:每次 startRecord 时 SDK 会按当前播放进度重新定位(setSpeed 后 seekTo 当前进度),不会把 BGM 重置到开头。只有当业务要求“每段都从同一位置起播”(例如卡点模板)时,才需要在两段之间手动 seekTo(目标位置)。

注意事项

片段的 BGM 信息在停止录制时记录,取的是当时正在播放的 BGM。因此录制过程中切换 BGM 会让该片的记录与前半段实际播放的音乐不一致,建议在两段之间切换。
BGM 只在录制期间播放:开始录制(渲染首帧)时自动 play,停止录制时自动 pause;ITAVBGMManager 没有播放/暂停接口,不支持录制前试听。
BGM 播放速度由 SDK 按录制速度自动换算:每次调用 startRecord(enableMic, speed) 时设为 1 / speed,以保证成片音画同步。setBGM 的 speed 无需调整,固定传 1.0f。
分段录制不会重置 BGM 位置,BGM 从停止处继续播放;需要每段重新对齐时自行调用 seekTo。
clearBGM() 只影响后续录制,不会修改已生成片段的 bgmPath。