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