播放信息获取

getDuration

获取媒体资源的时长。

C++

virtual int getDuration(int64_t& duration) = 0;

参数

duration

输出参数，媒体文件的总时长（毫秒）。

返回值

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

所属接口类

• IMediaPlayer

getMediaPlayerId

获取媒体播放器的 ID。

C++

virtual int getMediaPlayerId() const = 0;

返回值

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

所属接口类

• IMediaPlayer

getMute

查询媒体资源是否处于静音状态。

C++

virtual int getMute(bool& muted) = 0;

参数

muted

输出参数。媒体资源是否处于静音状态：

• 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：方法调用成功。
• < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。

所属接口类

• 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

输出参数，媒体资源中的媒体流数量。详见 int64_t

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。

所属接口类

• IMediaPlayer

getStreamInfo

获取媒体流的详细信息。

C++

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

调用时机

在调用 getStreamCount 方法之后调用该方法。

参数

index

媒体流的索引。该参数需小于 getStreamCount 返回的 count 值。

info

输出参数，媒体流的详细信息。详见 PlayerStreamInfo。

返回值

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

所属接口类

• IMediaPlayer

onPlayerPlaybackStats

播放中的媒体文件的统计信息回调。

C++

virtual void onPlayerPlaybackStats(const media::base::PlayerPlaybackStats& stats)

该回调每秒触发一次，用于报告播放中的媒体文件的统计信息。

参数

stats

媒体文件的统计信息。详见 PlayerPlaybackStats。

所属接口类

• IMediaPlayerSourceObserver