# 播放信息获取 (/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-info)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="toc_mediaplayer_info"></a>

<a id="api_imediaplayer_getaudiobufferdelay"></a>

<a id="ariaid-title2"></a>

## getAudioBufferDelay [#getaudiobufferdelay]

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

<a id="api_imediaplayer_getaudiobufferdelay__prototype"></a>

```java
int getAudioBufferDelay();
```

<a id="api_imediaplayer_getaudiobufferdelay__detailed_desc"></a>

<a id="api_imediaplayer_getaudiobufferdelay__return_values"></a>

### 返回值 [#返回值]

- 方法调用成功，返回音频缓冲延迟（单位：毫秒）。
- 方法调用失败，返回小于 0 的错误码。你可以使用 [MediaPlayerReason](/zh-CN/api-reference/rtc/android/enum-mediaplayerreason) 检查错误原因。

### 所属接口类 [#所属接口类]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getduration"></a>

<a id="ariaid-title3"></a>

## getDuration [#getduration]

获取媒体资源的时长。

<a id="api_imediaplayer_getduration__prototype"></a>

```java
long getDuration();
```

<a id="api_imediaplayer_getduration__detailed_desc"></a>

<a id="api_imediaplayer_getduration__return_values"></a>

### 返回值 [#返回值-1]

- 方法调用成功时，返回媒体文件的总时长（毫秒）。
- 方法调用失败时，返回小于 0 的值。

### 所属接口类 [#所属接口类-1]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getmediaplayerid"></a>

<a id="ariaid-title4"></a>

## getMediaPlayerId [#getmediaplayerid]

获取媒体播放器的 ID。

<a id="api_imediaplayer_getmediaplayerid__prototype"></a>

```java
int getMediaPlayerId();
```

<a id="api_imediaplayer_getmediaplayerid__detailed_desc"></a>

<a id="api_imediaplayer_getmediaplayerid__return_values"></a>

### 返回值 [#返回值-2]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-2]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getmute"></a>

<a id="ariaid-title5"></a>

## getMute [#getmute]

报告媒体资源是否被静音。

<a id="api_imediaplayer_getmute__prototype"></a>

```java
boolean getMute();
```

<a id="api_imediaplayer_getmute__detailed_desc"></a>

<a id="api_imediaplayer_getmute__return_values"></a>

### 返回值 [#返回值-3]

true：媒体资源已被静音。
false：媒体资源未被静音。

### 所属接口类 [#所属接口类-3]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getplayoutvolume"></a>

<a id="ariaid-title6"></a>

## getPlayoutVolume [#getplayoutvolume]

获取本地播放音量。

<a id="api_imediaplayer_getplayoutvolume__prototype"></a>

```java
int getPlayoutVolume();
```

<a id="api_imediaplayer_getplayoutvolume__detailed_desc"></a>

<a id="api_imediaplayer_getplayoutvolume__return_values"></a>

### 返回值 [#返回值-4]

方法调用成功，返回本地播放音量，取值范围为 0 到 100。
0 表示静音，100（默认）表示原始音量。

### 所属接口类 [#所属接口类-4]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getplayposition"></a>

<a id="ariaid-title7"></a>

## getPlayPosition [#getplayposition]

获取当前本地播放进度。

<a id="api_imediaplayer_getplayposition__prototype"></a>

```java
long getPlayPosition();
```

<a id="api_imediaplayer_getplayposition__detailed_desc"></a>

<a id="api_imediaplayer_getplayposition__return_values"></a>

### 返回值 [#返回值-5]

- 方法调用成功时，返回当前播放进度（单位为毫秒）。
- 方法调用失败时，返回小于 0 的值，详见 [MediaPlayerReason](/zh-CN/api-reference/rtc/android/enum-mediaplayerreason)。

### 所属接口类 [#所属接口类-5]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getplaysrc_imediaplayer"></a>

<a id="ariaid-title8"></a>

## getPlaySrc [1/2] [#getplaysrc-12]

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

<a id="api_imediaplayer_getplaysrc_imediaplayer__prototype"></a>

```java
String getPlaySrc();
```

<a id="api_imediaplayer_getplaysrc_imediaplayer__detailed_desc"></a>

<a id="api_imediaplayer_getplaysrc_imediaplayer__return_values"></a>

### 返回值 [#返回值-6]

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

### 所属接口类 [#所属接口类-6]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getpublishsignalvolume"></a>

<a id="ariaid-title9"></a>

## getPublishSignalVolume [#getpublishsignalvolume]

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

<a id="api_imediaplayer_getpublishsignalvolume__prototype"></a>

```java
int getPublishSignalVolume();
```

<a id="api_imediaplayer_getpublishsignalvolume__detailed_desc"></a>

<a id="api_imediaplayer_getpublishsignalvolume__return_values"></a>

### 返回值 [#返回值-7]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-7]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getstate"></a>

<a id="ariaid-title10"></a>

## getState [#getstate]

获取当前播放状态。

<a id="api_imediaplayer_getstate__prototype"></a>

```java
Constants.MediaPlayerState getState();
```

<a id="api_imediaplayer_getstate__detailed_desc"></a>

<a id="api_imediaplayer_getstate__return_values"></a>

### 返回值 [#返回值-8]

方法调用成功，返回当前播放状态。详见 [MediaPlayerState](/zh-CN/api-reference/rtc/android/enum-mediaplayerstate)。

### 所属接口类 [#所属接口类-8]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getstreamcount"></a>

<a id="ariaid-title11"></a>

## getStreamCount [#getstreamcount]

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

<a id="api_imediaplayer_getstreamcount__prototype"></a>

```java
int getStreamCount();
```

<a id="api_imediaplayer_getstreamcount__detailed_desc"></a>

:::note
注： 调用该方法前，请先调用 `open` 方法，并等待 [onPlayerStateChanged](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-observer#callback_imediaplayersourceobserver_onplayersourcestatechanged) 回调报告状态 `OPEN_COMPLETED`。
:::

<a id="api_imediaplayer_getstreamcount__return_values"></a>

### 返回值 [#返回值-9]

- 方法调用成功，返回媒体资源中的媒体流数量。
- &lt; 0：方法调用失败，详见 [MediaPlayerReason](/zh-CN/api-reference/rtc/android/enum-mediaplayerreason)。

### 所属接口类 [#所属接口类-9]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="api_imediaplayer_getstreaminfo"></a>

<a id="ariaid-title12"></a>

## getStreamInfo [#getstreaminfo]

获取媒体流的详细信息。

<a id="api_imediaplayer_getstreaminfo__prototype"></a>

```java
MediaStreamInfo getStreamInfo(int index);
```

<a id="api_imediaplayer_getstreaminfo__detailed_desc"></a>

调用 [getStreamCount](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 后，调用该方法获取指定索引的媒体流的详细信息。

<a id="api_imediaplayer_getstreaminfo__timing"></a>

### 调用时机 [#调用时机]

在调用 [getStreamCount](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 方法之后调用。

<a id="api_imediaplayer_getstreaminfo__parameters"></a>

### 参数 [#参数]

<ParameterList>
<a id="index"></a>
<Parameter name="index">

媒体流的索引。该参数必须小于 [getStreamCount](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 的返回值。

</Parameter>
</ParameterList>

<a id="api_imediaplayer_getstreaminfo__return_values"></a>

### 返回值 [#返回值-10]

- 方法调用成功，返回 [MediaStreamInfo](/zh-CN/api-reference/rtc/android/class-playerstreaminfo) 对象。
- 方法调用失败，返回 `null`。

### 所属接口类 [#所属接口类-10]

- [IMediaPlayer](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayer)

<a id="callback_imediaplayersourceobserver_onplayerplaybackstats"></a>

<a id="ariaid-title13"></a>

## onPlayerPlaybackStats [#onplayerplaybackstats]

报告正在播放的媒体文件的统计信息回调。

<a id="callback_imediaplayersourceobserver_onplayerplaybackstats__prototype"></a>

```java
void onPlayerPlaybackStats(PlayerPlaybackStats stats)
```

<a id="callback_imediaplayersourceobserver_onplayerplaybackstats__detailed_desc"></a>

该回调在媒体文件播放过程中每秒触发一次。

<a id="callback_imediaplayersourceobserver_onplayerplaybackstats__timing"></a>

### 触发时机 [#触发时机]

该回调在媒体文件播放过程中每秒触发一次。

<a id="callback_imediaplayersourceobserver_onplayerplaybackstats__parameters"></a>

### 参数 [#参数-1]

<ParameterList>
<a id="stats"></a>
<Parameter name="stats">

媒体文件的统计信息。详见 [PlayerPlaybackStats](/zh-CN/api-reference/rtc/android/class-playerplaybackstats)。

</Parameter>
</ParameterList>

### 所属接口类 [#所属接口类-11]

- [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_imediaplayersourceobserver)