# 播放信息获取 (/zh-CN/api-reference/rtc/cpp-all-platforms/play/mediaplayer/mediaplayer-info) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## getAudioBufferDelay [#getaudiobufferdelay] 获取播放媒体文件时的音频缓冲延迟。 ```cpp virtual int getAudioBufferDelay(int32_t& delayMs) = 0; ``` ### 参数 [#参数] 输出参数,表示播放媒体文件时的音频缓冲延迟,单位为毫秒。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getDuration [#getduration] 获取媒体资源的时长。 ```cpp virtual int getDuration(int64_t& duration) = 0; ``` ### 参数 [#参数-1] 输出参数,媒体文件的总时长(毫秒)。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getMediaPlayerId [#getmediaplayerid] 获取媒体播放器的 ID。 ```cpp virtual int getMediaPlayerId() const = 0; ``` ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getMute [#getmute] 查询媒体资源是否处于静音状态。 ```cpp virtual int getMute(bool& muted) = 0; ``` ### 参数 [#参数-2] 输出参数。媒体资源是否处于静音状态: - true:已静音。 - false:未静音。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getPlayoutVolume [#getplayoutvolume] 获取本地播放音量。 ```cpp virtual int getPlayoutVolume(int& volume) = 0; ``` ### 参数 [#参数-3] 输出参数,本地播放音量,取值范围为 0 到 100: - 0:静音。 - 100:(默认)原始音量。 ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getPlayPosition [#getplayposition] 获取当前音效文件的本地播放进度。 ```cpp virtual int getPlayPosition(int64_t& pos) = 0; ``` ### 参数 [#参数-4] 输出参数,音效文件的播放位置(单位:毫秒)。 ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getPlaySrc [#getplaysrc] 获取当前正在播放的媒体资源路径。 ```cpp virtual const char* getPlaySrc() = 0; ``` ### 返回值 [#返回值-6] - 方法调用成功时,返回当前正在播放的媒体资源路径。 - 方法调用失败,返回空字符串。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getPublishSignalVolume [#getpublishsignalvolume] 获取用于发布的媒体文件音量。 ```cpp virtual int getPublishSignalVolume(int& volume) = 0; ``` ### 参数 [#参数-5] 输出参数,用于获取远端播放的音量。 ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getState [#getstate] 获取当前播放状态。 ```cpp virtual media::base::MEDIA_PLAYER_STATE getState() = 0; ``` ### 返回值 [#返回值-8] 方法调用成功,返回当前播放状态,详见 [MEDIA_PLAYER_STATE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-mediaplayerstate)。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getStreamCount [#getstreamcount] 获取媒体资源中的媒体流数量。 ```cpp virtual int getStreamCount(int64_t& count) = 0; ``` :::note 注: 在调用该方法前,请先调用 [open](/zh-CN/api-reference/rtc/cpp-all-platforms/play/mediaplayer/mediaplayer-open#api_imediaplayer_open) 方法,并等待 [onPlayerSourceStateChanged](/zh-CN/api-reference/rtc/cpp-all-platforms/play/mediaplayer/mediaplayer-observer#callback_imediaplayersourceobserver_onplayersourcestatechanged) 回调报告状态 `PLAYER_STATE_OPEN_COMPLETED`。 ::: ### 参数 [#参数-6] 输出参数,媒体资源中的媒体流数量。详见 `int64_t` ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## getStreamInfo [#getstreaminfo] 获取媒体流的详细信息。 ```cpp virtual int getStreamInfo(int64_t index, media::base::PlayerStreamInfo* info) = 0; ``` ### 调用时机 [#调用时机] 在调用 [getStreamCount](/zh-CN/api-reference/rtc/cpp-all-platforms/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 方法之后调用该方法。 ### 参数 [#参数-7] 媒体流的索引。该参数需小于 [getStreamCount](/zh-CN/api-reference/rtc/cpp-all-platforms/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 返回的 `count` 值。 输出参数,媒体流的详细信息。详见 [PlayerStreamInfo](/zh-CN/api-reference/rtc/cpp-all-platforms/class-playerstreaminfo)。 ### 返回值 [#返回值-10] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-10] - [IMediaPlayer](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayer) ## onPlayerPlaybackStats [#onplayerplaybackstats] 播放中的媒体文件的统计信息回调。 ```cpp virtual void onPlayerPlaybackStats(const media::base::PlayerPlaybackStats& stats) ``` 该回调每秒触发一次,用于报告播放中的媒体文件的统计信息。 ### 参数 [#参数-8] 媒体文件的统计信息。详见 [PlayerPlaybackStats](/zh-CN/api-reference/rtc/cpp-all-platforms/class-playerplaybackstats)。 ### 所属接口类 [#所属接口类-11] - [IMediaPlayerSourceObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_imediaplayersourceobserver)