openWithSongCode abstract method

Future<void> openWithSongCode({
  1. required int songCode,
  2. int startPos = 0,
})

通过音乐资源编号打开音乐资源。

在调用此方法之前，请确保需要播放的音乐资源已加载完成。你可以调用 isPreloaded 方法来检测音乐资源是否已被预加载，或通过 onPreLoadEvent 回调得知。 调用该方法后会触发 onPlayerSourceStateChanged 回调。在收到报告播放状态为 playerStateOpenCompleted 后，你可以调用 play 方法播放媒体文件。 如果你想要打开的音乐资源受数字版权保护，则需要调用此方法打开。对于不受数字版权保护的音乐资源，你可以选择通过调用此方法或 MediaPlayer 类下的 open 方法来打开。

  • songCode 音乐资源的编号，用于标识音乐资源。
  • startPos 设置起始播放位置（毫秒），默认值为 0。

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

Implementation

Future<void> openWithSongCode({required int songCode, int startPos = 0});