初始化
createMediaPlayer
创建媒体播放器对象。
C++
virtual agora_refptr <IMediaPlayer> createMediaPlayer() = 0;
在调用 IMediaPlayer 类下的其他 API 前,你需要先调用该方法创建一个媒体播放器实例。如果你需要创建多个实例,可以多次调用该方法。
调用时机
该方法在加入频道前后均可调用。
调用限制
无。
返回值
- 方法调用成功:返回 IMediaPlayer 对象。
- 方法调用失败:返回空指针。
destroyMediaPlayer
销毁媒体播放器。
C++
virtual int destroyMediaPlayer(agora_refptr<IMediaPlayer> media_player) = 0;
参数
- media_player
IMediaPlayer 对象。
返回值
- ≥ 0: 方法调用成功,返回媒体播放器 ID
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
getMediaPlayerCacheManager
获取 IMediaPlayerCacheManager
实例。
C++
AGORA_API agora::rtc::IMediaPlayerCacheManager* AGORA_CALL getMediaPlayerCacheManager();
在调用 IMediaPlayerCacheManager 类下的其他 API 前,你需要先调用该方法获取一个媒体播放器缓存管理器的实例。
调用时机
请在初始化 IRtcEngine 后调用该方法。
调用限制
由于媒体播放器缓存管理器对象是单例模式,因此多次调用该方法将返回同一个实例。