preloadEffectEx abstract method

Future<void> preloadEffectEx({
  1. required RtcConnection connection,
  2. required int soundId,
  3. required String filePath,
  4. int startPos = 0,
})

将指定音效预加载到频道中。

自从 自 v4.6.2 版本新增。 每次调用该方法时，只能将一个音效文件预加载到内存中。如果需要预加载多个音效文件，请多次调用该方法。预加载完成后，可以调用 playEffect 播放预加载的音效，或调用 playAllEffects 播放所有预加载的音效。 为确保使用体验流畅，音效文件的大小不应超过限制。 声网建议在加入频道前调用该方法。 如果在调用 playEffectEx 前已调用 preloadEffectEx ，则 playEffectEx 执行后不会关闭文件资源。下次调用 playEffectEx 时会直接从头开始播放。 如果在调用 playEffectEx 前未调用 preloadEffectEx ，则 playEffectEx 执行后会销毁资源。下次调用 playEffectEx 时会尝试重新打开文件并从头开始播放。

  • connection 连接信息。详见 RtcConnection 。
  • soundId 音效 ID。
  • filePath 本地文件的绝对路径或在线文件的 URL。支持的音频格式包括：mp3、mp4、m4a、aac、3gp、mkv 和 wav。
  • startPos 音效文件的播放起始位置（单位为毫秒）。

Returns 0：方法调用成功。 < 0：方法调用失败。详见错误码了解详情和解决建议。

Implementation

Future<void> preloadEffectEx(
    {required RtcConnection connection,
    required int soundId,
    required String filePath,
    int startPos = 0});