功能概览
录制支持边录边播的背景音乐:录制过程中按设定速度播放,音乐信息会记录进每个录制片段(
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。