// 添加背景音乐
/// - 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;