preloadEffect abstract method

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

将音效文件加载至内存。

为保证通信畅通，请注意控制预加载音效文件的大小。 该方法支持的预加载音频文件的格式见 RTC SDK 支持播放哪些格式的音频文件。

  • soundId 音效的 ID。每个音效的 ID 具有唯一性。
  • filePath 文件路径： Android: 文件路径，需精确到文件名及后缀。支持在线文件的 URL 地址，本地文件的 URI 地址、绝对路径或以 /assets/ 开头的路径。通过绝对路径访问本地文件可能会遇到权限问题，建议使用 URI 地址访问本地文件。例如 content://com.android.providers.media.documents/document/audio%3A14441 。 Windows: 音频文件的绝对路径或 URL 地址，需精确到文件名及后缀。例如 C:\music\audio.mp4 。 iOS 或 macOS: 音频文件的绝对路径或 URL 地址，需精确到文件名及后缀。例如 /var/mobile/Containers/Data/audio.mp4 。
  • startPos 音效文件加载的起始位置，单位为毫秒。

Returns 方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

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