preloadEffect method

Future<void> preloadEffect (
  1. int soundId,
  2. String filePath
)

将音效文件预加载至内存。

支持音频格式为 mp3、mp4、m4a、aac、3gp、mkv 和 wav。

Note

  • 该方法不支持预加载在线音效文件。
  • 为保证通话流畅度，请注意控制音效文件的大小。Agora 推荐你在加入频道前调用该方法。

Parameter soundId 音效文件的 ID。

Parameter filePath 本地音乐文件的路径，需精确到文件名及后缀。

  • Android: 支持本地文件的 URI 地址、绝对路径或以 /assets/ 开头的路径。通过绝对路径访问本地文件可能会遇到权限问题，Agora 推荐使用 URI 地址访问本地文件。例如："content://com.android.providers.media.documents/document/audio%3A14441"。 支持的音频格式包括 MP3、AAC、M4A、MP4、WAV、3GP。详见 Android 支持的媒体格式。
  • iOS: 本地音乐文件的绝对路径。例如：/var/mobile/Containers/Data/audio.mp4。支持的音频格式包括 MP3、AAC、M4A、MP4、WAV、3GP。详见 Best Practices for iOS Audio.

Implementation

@override
Future<void> preloadEffect(int soundId, String filePath) {
  return _invokeMethod(
      'preloadEffect', {'soundId': soundId, 'filePath': filePath});
}