初始化
createMediaPlayerWithDelegate:
创建媒体播放器实例。
Objective-C
- (id<AgoraRtcMediaPlayerProtocol>_Nullable)createMediaPlayerWithDelegate:
(id<AgoraRtcMediaPlayerDelegate>_Nullable)delegate;
在调用 AgoraRtcMediaPlayerProtocol 类下的其他 API 前,你需要先调用该方法创建一个媒体播放器实例。如果你需要创建多个实例,可以多次调用该方法。
调用时机
该方法在加入频道前后均可调用。
调用限制
无。
参数
- delegate
- AgoraRtcEngineKit 的事件句柄,详见 AgoraRtcEngineDelegate。
返回值
- 方法调用成功:返回 AgoraRtcMediaPlayerProtocol 对象。
- 方法调用失败:返回空指针。
返回一个 AgoraRtcMediaPlayerProtocol 实例。
destroyMediaPlayer:
createMediaPlayerCacheManager
创建 AgoraRtcMediaPlayerCacheManagerProtocol
实例。
Objective-C
- (id<AgoraRtcMediaPlayerCacheManagerProtocol> _Nullable)createMediaPlayerCacheManager;
在调用 AgoraRtcMediaPlayerCacheManagerProtocol 类下的其他 API 前,你需要先调用该方法获取一个媒体播放器缓存管理器的实例。
调用时机
请在初始化 AgoraRtcEngineKit 后调用该方法。
调用限制
由于媒体播放器缓存管理器对象是单例模式,因此多次调用该方法将返回同一个实例。
返回值
所属接口类setVideoFrameDelegate:
注册媒体播放器的视频观测器对象。
Objective-C
- (BOOL)setVideoFrameDelegate:(id<AgoraRtcMediaPlayerVideoFrameDelegate> _Nullable)delegate NS_SWIFT_NAME(setVideoFrameDelegate(_:));
详情
调用该方法注册媒体播放器的视频观测器时,你可以根据需要注册 AgoraRtcMediaPlayerVideoFrameDelegate 类中的回调。在成功注册视频观测器后,SDK 会在捕捉到每个视频帧时,触发你所注册的上述回调。
参数
- delegate
- 接口对象实例,详见 AgoraRtcMediaPlayerVideoFrameDelegate。如果传入 nil,表示取消注册。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。