startAudioMixing method Null safety
- {required int mixId,
- required String filePath,
- required AudioMixingConfig config}
开始播放音乐文件及混音
mixId 区分混音任务的唯一标志。
如果已经通过 RTCAudioMixingManager.preloadAudioMixing 预加载音乐文件,请确保两者 ID 相同。
如果使用相同的 ID 重复调用本方法,前一次混音会停止,后一次混音开始,且会收到 RTCVideoEventHandler.onAudioMixingStateChanged。
filePath 需要混音的本地文件的绝对路径。
支持在线文件的 URL、本地文件的 URI、本地文件的绝对路径或以 /assets/ 开头的本地文件路径。对于在线文件的 URL,仅支持 https 协议。
不同平台支持的音乐文件格式如下:
| mp3 | mp4 | aac | m4a | 3gp | wav | ogg | |
|---|---|---|---|---|---|---|---|
| Android | Y | Y | Y | Y | Y | Y | Y |
| iOS | Y | Y | Y | Y | Y | Y |
注意:
- 可以通过传入不同的 mixId 和 filePath 多次调用本方法,以同时播放多个混音文件,实现混音叠加。
- 调用本方法成功播放音乐文件后,会收到 RTCVideoEventHandler.onAudioMixingStateChanged 提示当前的混音状态。
- 开始播放音乐文件及混音后,可以调用 RTCAudioMixingManager.stopAudioMixing 停止播放音乐文件。
Implementation
Future<void> startAudioMixing(
{required int mixId,
required String filePath,
required AudioMixingConfig config});