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