播放信息获取

  • C++

更新时间不可用

getAudioBufferDelay

获取播放媒体文件时的音频缓冲延迟。

C++
virtual int getAudioBufferDelay(int32_t& delayMs) = 0;

参数

参数名描述
delayMs

输出参数,表示播放媒体文件时的音频缓冲延迟,单位为毫秒。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

getDuration

获取媒体资源的时长。

C++
virtual int getDuration(int64_t& duration) = 0;

参数

参数名描述
duration

输出参数,媒体文件的总时长(毫秒)。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

getMediaPlayerId

获取媒体播放器的 ID。

C++
virtual int getMediaPlayerId() const = 0;

返回值

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

所属接口类

getMute

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

C++
virtual int getMute(bool& muted) = 0;

参数

参数名描述
muted

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

  • true:已静音。
  • false:未静音。
表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

getPlayoutVolume

获取本地播放音量。

C++
virtual int getPlayoutVolume(int& volume) = 0;

参数

参数名描述
volume

输出参数,本地播放音量,取值范围为 0 到 100:

  • 0:静音。
  • 100:(默认)原始音量。
表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

getPlayPosition

获取当前音效文件的本地播放进度。

C++
virtual int getPlayPosition(int64_t& pos) = 0;

参数

参数名描述
pos

输出参数,音效文件的播放位置(单位:毫秒)。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

getPlaySrc

获取当前正在播放的媒体资源路径。

C++
virtual const char* getPlaySrc() = 0;

返回值

  • 方法调用成功时,返回当前正在播放的媒体资源路径。
  • 方法调用失败,返回空字符串。

所属接口类

getPublishSignalVolume

获取用于发布的媒体文件音量。

C++
virtual int getPublishSignalVolume(int& volume) = 0;

参数

参数名描述
volume

输出参数,用于获取远端播放的音量。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

getState

获取当前播放状态。

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

返回值

方法调用成功,返回当前播放状态,详见 MEDIA_PLAYER_STATE。

所属接口类

getStreamCount

获取媒体资源中的媒体流数量。

C++
virtual int getStreamCount(int64_t& count) = 0;

注: 在调用该方法前,请先调用 open 方法,并等待 onPlayerSourceStateChanged 回调报告状态 PLAYER_STATE_OPEN_COMPLETED。

参数

参数名描述
count

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

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

getStreamInfo

获取媒体流的详细信息。

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

调用时机

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

参数

参数名描述
index

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

info

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

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

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

所属接口类

onPlayerPlaybackStats

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

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

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

参数

参数名描述
stats

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

表格内容超出当前宽度,可横向滚动查看更多列。

所属接口类