Discussion

• YES: 静音
• NO: 不静音

Discussion

Note：

• 当你同时使用 Agora RTC Native SDK 和 MediaPlayer Kit 时，如果 Native SDK 设置 audio scenario 是 GameStreaming(3)，Agora 推荐你设置 MediaPlayer Kit 使用媒体音量，并且同时集成 helper。
• 当你同时使用 Agora RTC Native SDK 和 MediaPlayer Kit 时，如果 Native SDK 设置 audio scenario 不是 GameStreaming(3)，Agora 推荐你设置 MediaPlayer Kit 使用通话音量。

Discussion

打开 open 媒体文件、 定位 seekToPosition 到媒体文件的指定播放位置或暂停 pause 播放媒体文件后，你可以调用该方法播放媒体文件。

Note:

MediaPlayer Kit only supports playing videos with framerate below 60fps (not including 60fps).

Discussion

如果你想恢复播放，请调用 play 方法。

Discussion

设置 MediaPlayer Kit 的输出 log 文件。MediaPlayer Kit 运行时产生的所有 log 将写入该文件。App 必须保证指定的目录存在而且可写。

Note：

• MediaPlayer Kit 的默认日志路径为 App Sandbox/Library/caches/agoraplayer.log。
• 如需调用本方法，请在创建 AgoraMediaPlayerKit 后立即调用，否则可能造成输出日志不完整。

Discussion

该方法设置 MediaPlayer Kit 的输出日志过滤等级。不同的过滤等级可以单独或组合使用。日志级别顺序依次为 OFF、 CRITICAL、ERROR、WARNING、INFO 和 DEBUG。选择一个级别，你就可以看到在该级别之前所有级别的 日志信息。 例如，你选择 WARNING 级别，就可以看到在 CRITICAL、ERROR 和 WARNING 级别上的所 有日志信息。

Discussion

MediaPlayer Kit 支持通过 key 和 value 来设置私有选项。一般情况下，你无需知晓私有选项设置，使用 Player 默认的选项设置即可。

Discussion

MediaPlayer Kit 支持通过 key 和 value 来设置私有选项。一般情况下，你无需知晓私有选项设置，使用 Player 默认的选项设置即可。

Discussion

打开 (open) 媒体文件后，你可以调用本方法改变播放速度。

Discussion

打开 (open) 媒体文件后，你可以调本方法选择播放时使用的音轨。

调用本方法前，请调用 getStreamByIndex 方法获取当前媒体流的音轨信息 AgoraMediaStreamInfo。 其中的 streamIndex 值即为本方法的 index 值。

Discussion

如果你希望循环播放，请调用该方法并设置循环播放次数。

循环播放结束时，Player 会返回 AgoraMediaPlayerStatePlayBackAllLoopsCompleted(6)

Discussion

调用该方法后，你将无法再使用 Player 提供的其他 API。如果你需要重新使用 Player， 你需要调用 initWithDelegate 方法，重新创建一个 AgoraMediaPlayer 实例。

Note：

• 该方法为同步调用。为避免死锁，Agora 建议你不要在回调中调用该方法。
• 如果你需要在销毁后再次创建 AgoraMediaPlayer 实例，请等待本方法执行结束后再创建。

Discussion

调用 open 方法成功打开媒体文件后，你可以调用本方法设置播放器显示外接字幕。

Discussion

你可以根据当前网络状态调用该方法切换播放的媒体资源。例如，在网络较差时，将播放的媒体资源切换为较低码率的媒体资源地址；在网络较好时，将播放的媒体资源切换为较高码率的媒体资源地址。

调用 switchSrc 后，如果你收到 didOccurEvent 回调报告事件 AgoraMediaPlayerEventSwitchComplete(9)，则切换成功；如果你收到 didOccurEvent 回调报告事件 AgoraMediaPlayerEventSwitchError(10)，则切换失败。

Note:

• 请确保在 open 之后调用该方法。
• 为保证播放正常，请在调用 switchSrc(src, true) 时注意如下：
• 不要在播放暂停时调用该方法。
• 不要在切换过程中调用 seekToPosition。
• 确保切换前的播放位置不大于待切换的媒体资源总时长。

Discussion

你可以调用该方法将一个媒体资源预加载到播放列表中。如果需要预加载多个媒体资源，你可以多次调用该方法。

调用 addPreloadSrc 后，如果收到 didPreloadEvent 回调报告事件 AgoraMediaPlayerPreloadEventComplete(9)，则预加载成功；如果你收到 didPreloadEvent 回调报告事件 PLAYER_EVENT_SWITCH_ERROR(10)，预加载失败。

预加载成功后，如果你想播放媒体资源，请调用 playPreload；如果你想清空播放列表，请调用 stop。

Note:

Agora 不支持你预加载重复的媒体资源到播放列表，但支持你将正在播放的媒体资源再次预加载到播放列表。

Discussion

该方法仅支持播放已预加载到播放列表中的媒体资源。调用该方法后，如果你收到 didChangedToState 回调报告状态 AgoraMediaPlayerStatePlaying(3)，播放成功。

如果你想更换播放的预加载媒体资源，你可以再次调用该方法并指定新的媒体资源路径。 如果你想重新播放媒体资源，你需要在播放前调用 addPreloadSrc 重新将该媒体资源预加载到播放列表。 如果你想清空播放列表，请调用 stop。

Note:

如果你在播放暂停时调用该方法，该方法会在恢复播放后才生效。