初始化

CreateMediaPlayer

创建媒体播放器对象。

C#

public abstract IMediaPlayer CreateMediaPlayer();

在调用 IMediaPlayer 类下的其他 API 前，你需要先调用该方法创建一个媒体播放器实例。如果你需要创建多个实例，可以多次调用该方法。

调用时机

该方法在加入频道前后均可调用。

调用限制

无。

返回值

• 方法调用成功：返回 IMediaPlayer 对象。
• 方法调用失败：返回空指针。

所属接口类

• IRtcEngine

DestroyMediaPlayer

销毁媒体播放器。

C#

public abstract int DestroyMediaPlayer(IMediaPlayer mediaPlayer);

参数

mediaPlayer

IMediaPlayer 对象。

返回值

• ≥ 0: 方法调用成功，返回媒体播放器 ID
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IRtcEngine

Dispose

释放媒体播放器占用的所有资源。

C#

public abstract void Dispose();

所属接口类

• IMediaPlayer

GetMediaPlayerCacheManager

获取 IMediaPlayerCacheManager 实例。

C#

public abstract IMediaPlayerCacheManager GetMediaPlayerCacheManager();

在调用 IMediaPlayerCacheManager 类下的其他 API 前，你需要先调用该方法获取一个媒体播放器缓存管理器的实例。

调用时机

请在初始化 IRtcEngine 后调用该方法。

调用限制

由于媒体播放器缓存管理器对象是单例模式，因此多次调用该方法将返回同一个实例。

返回值

IMediaPlayerCacheManager 实例。

所属接口类

• IMediaPlayer

InitEventHandler

添加媒体播放器的回调事件。

C#

public abstract int InitEventHandler(IMediaPlayerSourceObserver engineEventHandler);

参数

engineEventHandler

待添加的回调事件，详见 IMediaPlayerSourceObserver。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer