播放信息获取

getDuration

获取媒体文件总时长。

C++

virtual int getDuration(int64_t& duration) = 0;

参数

参数名	描述
duration	输出参数。媒体文件总时长（毫秒）。

返回值

• 0: 方法调用成功。

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

所属接口类

• IMediaPlayer

getMediaPlayerId

获取播放器 ID。

C++

virtual int getMediaPlayerId() const = 0; 

返回值

• 方法调用成功，返回播放器 ID。

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

所属接口类

• IMediaPlayer

getMute

获取当前播放的媒体文件是否静音。

C++

virtual int getMute(bool& mute) = 0;

参数

参数名	描述
mute	输出参数。静音状态： true: 静音。 false: 不静音。

返回值

• 0: 方法调用成功。

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

所属接口类

• IMediaPlayer

getPlayoutVolume

获取当前本地播放音量。

C++

virtual int getPlayoutVolume(int& volume) = 0;

参数

参数名	描述
volume	输出参数。本地播放音量，取值范围从 0 到 100： 0: 无声。 100: （默认）媒体文件的原始播放音量。

返回值

• 0: 方法调用成功。

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

所属接口类

• IMediaPlayer

getPlayPosition

获取当前播放进度。

C++

virtual int getPlayPosition(int64_t& pos) = 0;

参数

参数名	描述
pos	媒体资源文件当前的播放位置，单位为毫秒。

返回值

• 方法调用成功，返回当前播放进度（毫秒）。

• < 0: 方法调用失败，详见 MEDIA_PLAYER_ERROR。

所属接口类

• IMediaPlayer

getPlaySrc

获取播放的媒体资源的路径。

C++

virtual const char* getPlaySrc() = 0;

返回值

播放的媒体资源的路径。

所属接口类

• IMediaPlayer

getPublishSignalVolume

获取远端用户听到的音量。

C++

virtual int getPublishSignalVolume(int& volume) = 0;

参数

参数名	描述
volume	输出参数。播放文件的远端播放音量。

返回值

• 0: 方法调用成功。

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

所属接口类

• IMediaPlayer

getState

获取播放器当前状态。

C++

virtual media::base::MEDIA_PLAYER_STATE getState() = 0;

返回值

播放器当前状态，详见 MEDIA_PLAYER_STATE。

所属接口类

• IMediaPlayer

getStreamCount

获取当前媒体文件中媒体流的数量。

C++

virtual int getStreamCount(int64_t& count) = 0;

注意： 请在 open 后并收到 onPlayerSourceStateChanged 回调报告播放状态为 PLAYER_STATE_OPEN_COMPLETED 后再调用该方法。

参数

参数名	描述
count	输出参数。当前媒体文件中媒体流的数量。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败，详见 MEDIA_PLAYER_ERROR。

所属接口类

• IMediaPlayer

getStreamInfo

通过媒体流的索引值获取媒体流信息。

C++

virtual int getStreamInfo(int64_t index, media::base::PlayerStreamInfo* info) = 0;

注意： 你需要在 getStreamCount 后调用该方法。

参数

参数名	描述
index	媒体流索引值。
info	该参数需小于 getStreamCount 的 count 参数。

返回值

• 0: 方法调用成功。

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

所属接口类

• IMediaPlayer