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