短视频 SDK Android（背景音乐）

一、相关接口类

接口类名	描述
TAVEditor	SDK 操作入口类。

二、接口方法汇总

方法	参数	返回值	说明
addBgm(String path, long startAtVideoTimeUS, long startTimeUS, long duration)	path：音乐路径。startAtVideoTimeUS：在视频中开始的时间(us)。startTimeUS：音乐开始时间(us)。duration：播放时长(us)。	int	添加背景音乐并返回 ID。
removeBgm(int bgmID)	bgmID：背景音乐 ID。	boolean	删除背景音乐。
updateBgmPlayOffset(int bgmID, long videoStartTime)	bgmID：背景音乐 ID。videoStartTime：视频位置(us)。	void	调整背景音乐在视频中的位置。
updateBgmPlayRange(int bgmID, long startTime, long duration)	bgmID：背景音乐 ID。startTime：开始时间(us)。duration：播放时长(us)。	void	调整背景音乐播放区间。
setBgmVolume(int bgmID, float volume)	bgmID：背景音乐 ID。volume：音量建议范围为0-3f。	void	设置单个背景音乐音量。
setAllBgmVolume(float volume)	volume：音量建议范围为0-3f。	void	设置所有背景音乐音量。
getBgmVolume(int bgmID)	bgmID：背景音乐 ID。	float	获取背景音乐音量。
setBgmSpeed(int bgmID, float speed)	bgmID：背景音乐 ID。speed：播放速度。	void	设置背景音乐播放速度。
getBgmSpeed(int bgmID)	bgmID：背景音乐 ID。	float	获取背景音乐播放速度。

三、添加背景音乐

/** * 添加背景音乐 * * @param path 音乐文件路径 * @param startAtVideoTimeUS 背景音乐在视频中出现的时间点(微秒) * @param startTimeUS 背景音乐自身的开始播放时间(微秒) * @param duration 背景音乐播放时长(微秒) * @return 背景音乐唯一ID */int bgmId = editor.addBgm(path, startAtVideoTimeUS, startTimeUS, duration);

四、删除背景音乐

/** * 删除背景音乐 * * @param bgmId 背景音乐ID * @return 是否删除成功 */boolean success = editor.removeBgm(bgmId);

五、调整背景音乐位置

/** * 调整背景音乐在视频中的位置 * * @param bgmId 背景音乐ID * @param videoStartTime 新的视频时间点(微秒) */editor.updateBgmPlayOffset(bgmId, videoStartTime);

六、调整背景音乐播放区间

/** * 调整背景音乐播放区间 * * @param bgmId 背景音乐ID * @param startTime 新的开始时间(微秒) * @param duration 新的播放时长(微秒) */editor.updateBgmPlayRange(bgmId, startTime, duration);

七、调整音量

/** * 设置单个背景音乐音量 * * @param bgmId 背景音乐ID * @param volume 音量值，建议范围: 0-3f */editor.setBgmVolume(bgmId, volume);/** * 设置所有背景音乐音量 * * @param volume 音量值，建议范围: 0-3f */editor.setAllBgmVolume(volume);/** * 获取背景音乐音量 * * @param bgmId 背景音乐ID * @return 当前音量值 */float volume = editor.getBgmVolume(bgmId);

八、调整播放速度

/** * 设置背景音乐播放速度 * * @param bgmId 背景音乐ID * @param speed 播放速度(1.0=正常速度) */editor.setBgmSpeed(bgmId, speed);/** * 获取背景音乐播放速度 * * @param bgmId 背景音乐ID * @return 当前播放速度 */float speed = editor.getBgmSpeed(bgmId);

九、使用示例

// 添加背景音乐（从视频第2秒开始，播放音乐开头的4秒内容）int bgmId = editor.addBgm(context.getFilesDir() + "/music.mp3", 2_000_000, // 视频中开始时间 0, // 音乐开始时间 4_000_000); // 播放时长// 调整音量到70%editor.setBgmVolume(bgmId, 0.7f);// 调整播放速度到1.5倍editor.setBgmSpeed(bgmId, 1.5f);// 在视频中的第5s开始播放音乐editor.updateBgmPlayOffset(bgmId, 5_000_000);// 调整音乐播放区间（从音乐第1秒开始，播放2秒）editor.updateBgmPlayRange(bgmId, 1_000_000, // 开始时间 2_000_000); // 播放时长// 获取当前ID背景音乐音量（需在删除前读取）float currentVolume = editor.getBgmVolume(bgmId);// 删除背景音乐boolean success = editor.removeBgm(bgmId);