初始化
- macOS
更新时间不可用
createMediaPlayerWithDelegate:
创建一个媒体播放器实例。
- (id<AgoraRtcMediaPlayerProtocol>_Nullable)createMediaPlayerWithDelegate:(id<AgoraRtcMediaPlayerDelegate>_Nullable)delegate NS_SWIFT_NAME(createMediaPlayer(with:));在调用 AgoraRtcMediaPlayerProtocol 中的任何 API 之前，你需要调用该方法创建一个媒体播放器实例。如果你需要创建多个实例，可以多次调用该方法。
调用时机
你可以在加入频道前或加入频道后调用此方法。
参数
| 参数名 | 描述 |
|---|---|
delegate | 事件回调处理器，详见 AgoraRtcMediaPlayerDelegate。 |
返回值
- 方法调用成功，返回 AgoraRtcMediaPlayerProtocol 实例。
- 方法调用失败，返回 nil。
所属接口类
destroyMediaPlayer:
销毁媒体播放器实例。
- (int)destroyMediaPlayer:(id<AgoraRtcMediaPlayerProtocol>_Nullable)mediaPlayer NS_SWIFT_NAME(destroyMediaPlayer(_:));参数
| 参数名 | 描述 |
|---|---|
mediaPlayer | 要销毁的媒体播放器实例，类型为 AgoraRtcMediaPlayerProtocol。详见 AgoraRtcMediaPlayerProtocol。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
createMediaPlayerCacheManager
创建一个 AgoraRtcMediaPlayerCacheManagerProtocol 实例。
- (id<AgoraRtcMediaPlayerCacheManagerProtocol> _Nullable)createMediaPlayerCacheManager NS_SWIFT_NAME(createMediaPlayerCacheManager());在调用 AgoraRtcMediaPlayerCacheManagerProtocol 中的任何 API 之前，你需要调用此方法以获取媒体播放器的缓存管理器实例。
注： createMediaPlayerCacheManager 返回的缓存管理器为单例模式。因此，多次调用此方法会返回相同的实例。
调用时机
确保在调用此方法之前已初始化 AgoraRtcEngineKit。
返回值
方法调用成功，返回 AgoraRtcMediaPlayerCacheManagerProtocol 对象。
所属接口类
setVideoFrameDelegate:
注册媒体播放器的视频帧观察者对象。
- (BOOL)setVideoFrameDelegate:(id<AgoraRtcMediaPlayerVideoFrameDelegate> _Nullable)delegate NS_SWIFT_NAME(setVideoFrameDelegate(_:));调用该方法注册视频帧观察者后，你可以根据需要在 AgoraRtcMediaPlayerVideoFrameDelegate 中注册回调。成功注册视频帧观察者后，每当接收到视频帧时，SDK 会触发已注册的回调。
参数
| 参数名 | 描述 |
|---|---|
delegate | 代理实例。设置为 nil 可释放该实例。详见 AgoraRtcMediaPlayerVideoFrameDelegate。 |
返回值
- YES：注册成功。
- NO：注册失败。