preloadAudioMixing abstract method
- @Deprecated('Deprecated since v3.54, use RTCAudioEffectPlayer.preload instead')
预加载指定音乐文件到内存中,以避免频繁播放同一文件时的重复加载,减少 CPU 占用。
如果先调用 RTCAudioMixingManager.startAudioMixing,再使用相同的 ID 调用本方法,会先停止当前混音任务,然后加载混音文件。
调用本方法预加载 A.mp3 后,如果需要使用相同的 ID 播放 B.mp3,请先调用 RTCAudioMixingManager.unloadAudioMixing 卸载 A.mp3。
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 |
如果音乐文件长度超过 20s,会回调加载失败,收到 RTCVideoEventHandler.onAudioMixingStateChanged。
注意:
- 调用本方法预加载音乐文件后,会收到 RTCVideoEventHandler.onAudioMixingStateChanged。
- 调用本方法预加载的指定音乐文件可以通过 RTCAudioMixingManager.unloadAudioMixing 卸载。
Implementation
@Deprecated(
'Deprecated since v3.54, use RTCAudioEffectPlayer.preload instead')
Future<void> preloadAudioMixing({
required int mixId,
required String filePath,
});