# 播放信息获取 (/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer/mediaplayer-info) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## GetDuration [#getduration] 获取媒体文件总时长。 ```csharp public abstract int GetDuration(ref Int64 duration); ``` ### 参数 [#参数] 输出参数。媒体文件总时长(毫秒)。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetId [#getid] 获取播放器 ID。 ```csharp public abstract int GetId(); ``` ### 返回值 [#返回值-1] - 方法调用成功,返回播放器 ID。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetMute [#getmute] 获取当前播放的媒体文件是否静音。 ```csharp public abstract int GetMute(ref bool muted); ``` ### 参数 [#参数-1] 输出参数。静音状态: - `true`: 媒体文件已静音。 - `false`: 媒体文件未静音。 ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetPlayoutVolume [#getplayoutvolume] 获取当前本地播放音量。 ```csharp public abstract int GetPlayoutVolume(ref int volume); ``` ### 参数 [#参数-2] 输出参数。本地播放音量,取值范围从 0 到 100: - 0: 无声。 - 100: (默认)媒体文件的原始播放音量。 ### 返回值 [#返回值-3] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetPlayPosition [#getplayposition] 获取当前播放进度。 ```csharp public abstract int GetPlayPosition(ref Int64 pos); ``` ### 参数 [#参数-3] 媒体资源文件当前的播放位置,单位为毫秒。 ### 返回值 [#返回值-4] - 方法调用成功,返回当前播放进度(毫秒)。 - < 0: 方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetPlaySrc [#getplaysrc] 获取播放的媒体资源的路径。 ```csharp public abstract string GetPlaySrc(); ``` ### 返回值 [#返回值-5] 播放的媒体资源的路径。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetPublishSignalVolume [#getpublishsignalvolume] 获取远端用户听到的音量。 ```csharp public abstract int GetPublishSignalVolume(ref int volume); ``` ### 参数 [#参数-4] 输出参数。播放文件的远端播放音量。 ### 返回值 [#返回值-6] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetState [#getstate] 获取播放器当前状态。 ```csharp public abstract MEDIA_PLAYER_STATE GetState(); ``` ### 返回值 [#返回值-7] 播放器当前状态,详见 [MEDIA_PLAYER_STATE](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerstate)。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetStreamCount [#getstreamcount] 获取当前媒体文件中媒体流的数量。 ```csharp public abstract int GetStreamCount(ref Int64 count); ``` ### 详情 [#详情] :::caution 注意: 请在 [Open](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer/mediaplayer-open#api_imediaplayer_open) 后并收到 [OnPlayerSourceStateChanged](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer/mediaplayer-observer#callback_imediaplayersourceobserver_onplayersourcestatechanged) 回调报告播放状态为 PLAYER_STATE_OPEN_COMPLETED 后再调用该方法。 ::: ### 参数 [#参数-5] 输出参数。当前媒体文件中媒体流的数量。 ### 返回值 [#返回值-8] - 0: 方法调用成功。 - < 0: 方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer) ## GetStreamInfo [#getstreaminfo] 通过媒体流的索引值获取媒体流信息。 ```csharp public abstract int GetStreamInfo(Int64 index, ref PlayerStreamInfo info); ``` ### 调用时机 [#调用时机] 你需要在 [GetStreamCount](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 后调用该方法。 ### 调用限制 [#调用限制] 无。 ### 参数 [#参数-6] 媒体流索引值。该参数需小于 [GetStreamCount](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 的 count 参数。 输出参数。媒体流的所有信息,详见 [PlayerStreamInfo](/zh-CN/api-reference/rtc/csharp-windows/class-playerstreaminfo)。 ### 返回值 [#返回值-9] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayer](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayer)