# 播放信息获取 (/zh-CN/api-reference/rtc/electron/play/mediaplayer/mediaplayer-info) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## getAudioBufferDelay [#getaudiobufferdelay] 获取播放媒体文件时的音频缓冲延迟。 ```ts abstract getAudioBufferDelay(): number; ``` ### 参数 [#参数] 输出参数,表示播放媒体文件时的音频缓冲延迟,单位为毫秒。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getDuration [#getduration] 获取媒体文件总时长。 ```ts abstract getDuration(): number; ``` ### 返回值 [#返回值-1] 媒体文件总时长(毫秒)。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getMediaPlayerId [#getmediaplayerid] 获取播放器 ID。 ```ts abstract getMediaPlayerId(): number; ``` ### 返回值 [#返回值-2] - 方法调用成功,返回播放器 ID。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getMute [#getmute] 获取当前播放的媒体文件是否静音。 ```ts abstract getMute(): boolean; ``` ### 返回值 [#返回值-3] - true:当前播放的媒体文件为静音。 - false:当前播放的媒体文件没有静音。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getPlayoutVolume [#getplayoutvolume] 获取当前本地播放音量。 ```ts abstract getPlayoutVolume(): number; ``` ### 返回值 [#返回值-4] 返回当前本地播放音量,取值范围从 0 到 100: - 0: 无声。 - 100: (默认)媒体文件的原始播放音量。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getPlayPosition [#getplayposition] 获取当前播放进度。 ```ts abstract getPlayPosition(): number; ``` ### 返回值 [#返回值-5] - 方法调用成功,返回当前播放进度(毫秒)。 - < 0: 方法调用失败,详见 [MediaPlayerReason](/zh-CN/api-reference/rtc/electron/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getPlaySrc [#getplaysrc] 获取播放的媒体资源的路径。 ```ts abstract getPlaySrc(): string; ``` ### 返回值 [#返回值-6] 播放的媒体资源的路径。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getPublishSignalVolume [#getpublishsignalvolume] 获取远端用户听到的音量。 ```ts abstract getPublishSignalVolume(): number; ``` ### 返回值 [#返回值-7] - ≥ 0: 播放文件的远端播放音量。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getState [#getstate] 获取播放器当前状态。 ```ts abstract getState(): MediaPlayerState; ``` ### 返回值 [#返回值-8] 播放器当前状态,详见 [MediaPlayerState](/zh-CN/api-reference/rtc/electron/enum-mediaplayerstate)。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getStreamCount [#getstreamcount] 获取当前媒体文件中媒体流的数量。 ```ts abstract getStreamCount(): number; ``` :::note 注: 请在 [open](/zh-CN/api-reference/rtc/electron/play/mediaplayer/mediaplayer-open#api_imediaplayer_open) 后并收到 [onPlayerSourceStateChanged](/zh-CN/api-reference/rtc/electron/play/mediaplayer/mediaplayer-observer#callback_imediaplayersourceobserver_onplayersourcestatechanged) 回调报告播放状态为 `PlayerStateOpenCompleted` 后再调用该方法。 ::: ### 返回值 [#返回值-9] - 方法调用成功,返回该媒体文件中媒体流的数量。 - < 0: 方法调用失败,详见 [MediaPlayerReason](/zh-CN/api-reference/rtc/electron/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## getStreamInfo [#getstreaminfo] 通过媒体流的索引值获取媒体流信息。 ```ts abstract getStreamInfo(index: number): PlayerStreamInfo; ``` ### 调用时机 [#调用时机] 你需要在 [getStreamCount](/zh-CN/api-reference/rtc/electron/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 后调用该方法。 ### 参数 [#参数-1] 媒体流索引值。该参数的值需小于 [getStreamCount](/zh-CN/api-reference/rtc/electron/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 的返回值。 ### 返回值 [#返回值-10] - 方法调用成功,返回媒体流信息,详见 [PlayerStreamInfo](/zh-CN/api-reference/rtc/electron/class-playerstreaminfo)。 - 方法调用失败,返回 null。 ### 所属接口类 [#所属接口类-10] - [IMediaPlayer](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayer) ## onPlayerPlaybackStats [#onplayerplaybackstats] 报告当前播放的媒体资源的相关信息。 ```ts onPlayerPlaybackStats?(stats: PlayerPlaybackStats): void; ``` 当媒体资源开始播放后,SDK 会每秒触发一次该回调,报告媒体资源的相关信息。 ### 参数 [#参数-2] 媒体资源的相关信息,详见 [PlayerPlaybackStats](/zh-CN/api-reference/rtc/electron/class-playerplaybackstats)。 ### 所属接口类 [#所属接口类-11] - [IMediaPlayerSourceObserver](/zh-CN/api-reference/rtc/electron/rtc-interface-class#class_imediaplayersourceobserver)