start abstract method

Future<int?> start(
  1. int effectId, {
  2. required String filePath,
  3. AudioEffectPlayerConfig config = const AudioEffectPlayerConfig(),
})

开始播放音效文件。
可以通过传入不同的 effectId 和 filePath 多次调用本方法,以实现同时播放多个音效文件,实现音效叠加。

effectId:音效 ID。用于标识音效,请保证音效 ID 唯一性。
如果使用相同的 ID 重复调用本方法后,上一个音效会停止,下一个音效开始,并收到 RTCAudioEffectPlayerEventHandler.onAudioEffectPlayerStateChanged

filePath:音效文件路径。
支持在线文件的 URL、本地文件的 URI、本地文件的绝对路径或以 /assets/ 开头的本地文件路径。对于在线文件的 URL,仅支持 https 协议。
推荐的音效文件采样率:8KHz、16KHz、22.05KHz、44.1KHz、48KHz。
不同平台支持的本地音效文件格式:

mp3mp4aacm4a3gpwavoggtswma
AndroidYYYYYYY
iOS/macOSYYYYYY
WindowsYYYYYYYY
不同平台支持的在线音效文件格式:
mp3mp4aacm4a3gpwavoggtswma
AndroidYYYYY
iOS/macOSYYYY
WindowsYYYYYYY

config:音效配置,详见 AudioEffectPlayerConfig

返回值:

  • 0:调用成功;
  • <0:调用失败。

注意:

Implementation

Future<int?> start(
  int effectId, {
  required String filePath,
  AudioEffectPlayerConfig config = const AudioEffectPlayerConfig(),
});