背景音乐混音(旧版)
本部分介绍背景音乐混音功能的使用
注意,自 SDK 4.2.0 版本开始,发布了新版本的混音功能,新版本混音功能支持多重音效且功能更强大,具体接入参考混音功能(新版)。
用户可在连麦过程中通过混音功能添加背景音乐,支持 MP3、AAC 等格式的本地或在线音乐,使用方式如下:
创建 QNAudioMixer
SDK 当前仅支持基于 QNMicrophoneAudioTrack 的混音功能,因此,可以通过 QNMicrophoneAudioTrack 创建 QNAudioMixer 对象。
const filePath = "/sdcard/music/example.mp3";
const mAudioMixer = mMicrophoneAudioTrack.createAudioMixer(filePath)
createAudioMixer
不仅支持文件地址,同时还支持 AudioBuffer 与 File 类型。
混音控制
在创建了 QNAudioMixer 实例后,可以通过该实例提供的混音控制接口进行混音操作的控制,使用代码参考如下:
// 开始混音
mAudioMixer.start();
// 停止混音
mAudioMixer.stop();
// 恢复混音
mAudioMixer.resume();
// 暂停混音
mAudioMixer.pause();
// 设置混音音量,默认值1
// 0表示静音 1表示原始音量
// 建议设置范围:0-10 之间的浮点数
mAudioMixer.setPlayingVolume(volume);
上述为混音基本流程的控制,更多控制方式请参考 QNAudioMixer。
当前仅支持一个麦克风 track 混一路音频,重复针对同一个麦克风 track 创建不同的 QNAudioMixer 并执行 start 操作,后面的会覆盖前面的,即以后执行 start 的音频混音控制器为准进行混音。
示例代码
背景音乐混音场景的示例代码可参考 API-Examples-Web/audioMixing
文档反馈
(如有产品使用问题,请 提交工单)