初始化
createMediaPlayer
创建一个 IMediaPlayer 对象。
C++
virtual agora_refptr<IMediaPlayer> createMediaPlayer() = 0;
在调用 IMediaPlayer 中的任何 API 之前,必须先调用该方法创建一个 IMediaPlayer 实例。如果需要多个实例,可以多次调用该方法。
调用时机
你可以在加入频道前或加入频道后调用此方法。
返回值
- 方法调用成功,返回 IMediaPlayer 对象,详见 IMediaPlayer。
- 方法调用失败,返回 NULL。
destroyMediaPlayer
销毁一个 IMediaPlayer 实例。
C++
virtual int destroyMediaPlayer(agora_refptr<IMediaPlayer> media_player) = 0;
参数
- media_player
- IMediaPlayer 对象。详见 IMediaPlayer。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
getMediaPlayerCacheManager
获取一个 IMediaPlayerCacheManager 实例。
C++
AGORA_API agora::rtc::IMediaPlayerCacheManager* AGORA_CALL getMediaPlayerCacheManager();
在调用 IMediaPlayerCacheManager 中的任何 API 前,你需要调用该方法获取媒体播放器的缓存管理器实例。
信息
IMediaPlayerCacheManager 采用单例模式,因此多次调用该方法会返回同一个实例。
调用时机
调用时序:请确保在调用该方法前已初始化 IRtcEngine。
返回值
- 方法调用成功,返回 IMediaPlayerCacheManager 实例,详见 IMediaPlayerCacheManager。
- 方法调用失败,返回 NULL。