功能概览
通过背景音乐（BGM）相关接口，可以实现对短视频进行插入背景音/音乐。本文提供背景音乐管理功能说明，包括添加、删除、调整位置、音量、播放速度和区间等操作。
相关接口类
接口类名 | 描述 |
TAVEditor | SDK 操作入口类。 |
背景音乐相关方法
添加背景音乐
// 添加背景音乐/// - Parameters:/// - bgmPath: 音乐素材的文件路径/// - startAtVideoTime: BGM在时间轴中开始播放的时间(默认为0)，比如主轨道是一个10s视频，选择在第5s才开始添加BGM播放，则传5s对应的CMTime/// - timeRange: 截取音乐素材的播放的区间(默认为整首),如一首歌时长为0-90s，设置timerange可以截取0-90任意一段的音频来使用/// - retrun: bgm素材唯一ID- (int)addBgm:(NSString *)bgmPath startAtVideoTime:(CMTime)startAtVideoTime timeRange:(CMTimeRange)timeRange;
删除背景音乐
/// 根据唯一ID删除背景音乐/// - Parameter bgmId: 背景音乐添加时生成的ID- (BOOL)removeBgm:(int)bgmId;/// 删除所有bgm- (void)removeAllBgm;
调整背景音乐在视频中的起始播放时间
/// 调整Bgm在视频中开始的位置，该功能暂未生效/// - Parameters:/// - bgmId: 背景音乐添加时生成的ID/// - startAtVideoTime: BGM在时间轴中开始播放的时间，比如主轨道是一个10s视频，选择在第5s才开始添加BGM播放，则传5s对应的CMTime- (void)updateBgm:(int)bgmId atVideoTime:(CMTime)startAtVideoTime;
调整背景音乐播放区间
/// 设置背景音乐播放区间/// - Parameters:/// - bgmId: 背景音乐添加时生成的ID/// - timeRange: 截取音乐素材的播放的区间(默认为整首),如一首歌时长为0-90s，设置timerange可以截取0-90任意一段的音频来使用- (void)updateBgm:(int)bgmId playRange:(CMTimeRange)timeRange;
调整背景音乐音量
/// 设置背景音乐播放音量/// - Parameters:/// - bgmId: 背景音乐添加时生成的ID/// - volume: 音量 0-1f- (void)setBgm:(int)bgmId volume:(float)volume;/// 设置所有背景音乐播放音量/// - Parameters:/// - volume: 音量 0-1f- (void)setAllBgmVolume:(float)volume;/// 获取背景音乐音量/// - Parameters:/// - bgmId: 背景音乐添加时生成的ID/// - retrun: 音量- (float)getBgmVolume:(int)bgmId;
调整背景音乐倍速
/// 调整背景音乐播放速度/// - Parameters:/// - bgmId: 背景音乐添加时生成的ID/// - speed: 播放速度 1正常 大于1快 小于1慢- (void)setBgm:(int)bgmId speed:(float)speed;/// 获取背景音乐播放速度/// - Parameters:/// - bgmID 背景音乐添加时生成的ID/// -return 当前BGM播放速度- (float)getBgmSpeed:(int)bgmId;
