播放信息获取

getDuration

获取媒体文件总时长。

TypeScript

abstract getDuration(): number;

返回值

媒体文件总时长（毫秒）。

所属接口类

• IMediaPlayer

getMediaPlayerId

获取播放器 ID。

TypeScript

abstract getMediaPlayerId(): number;

返回值

• 方法调用成功，返回播放器 ID。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

getMute

获取当前播放的媒体文件是否静音。

TypeScript

abstract getMute(): boolean;

返回值

• true：当前播放的媒体文件为静音。
• false：当前播放的媒体文件没有静音。

所属接口类

• IMediaPlayer

getPlayoutVolume

获取当前本地播放音量。

TypeScript

abstract getPlayoutVolume(): number;

返回值

返回当前本地播放音量，取值范围从 0 到 100：

• 0: 无声。
• 100: （默认）媒体文件的原始播放音量。

所属接口类

• IMediaPlayer

getPlayPosition

获取当前播放进度。

TypeScript

abstract getPlayPosition(): number;

返回值

• 方法调用成功，返回当前播放进度（毫秒）。
• < 0: 方法调用失败，详见 MediaPlayerReason。

所属接口类

• IMediaPlayer

getPublishSignalVolume

获取远端用户听到的音量。

TypeScript

abstract getPublishSignalVolume(): number;

返回值

• ≥ 0: 播放文件的远端播放音量。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

getState

获取播放器当前状态。

TypeScript

abstract getState(): MediaPlayerState;

返回值

播放器当前状态，详见 MediaPlayerState。

所属接口类

• IMediaPlayer

getStreamCount

获取当前媒体文件中媒体流的数量。

TypeScript

abstract getStreamCount(): number;

详情

注意

请在 open 后并收到 onPlayerSourceStateChanged 回调报告播放状态为 PlayerStateOpenCompleted 后再调用该方法。

返回值

• 方法调用成功，返回该媒体文件中媒体流的数量。
• < 0: 方法调用失败，详见 MediaPlayerReason。

所属接口类

• IMediaPlayer

getStreamInfo

通过媒体流的索引值获取媒体流信息。

TypeScript

abstract getStreamInfo(index: number): PlayerStreamInfo;

调用时机

你需要在 getStreamCount 后调用该方法。

调用限制

无。

参数

index

媒体流索引值。该参数的值需小于 getStreamCount 的返回值。

返回值

• 方法调用成功，返回媒体流信息，详见 PlayerStreamInfo。
• 方法调用失败，返回 null。

所属接口类

• IMediaPlayer

onPlayerPlaybackStats

报告当前播放的媒体资源的相关信息。

TypeScript

onPlayerPlaybackStats?(stats: PlayerPlaybackStats): void;

详情

当媒体资源开始播放后，SDK 会每秒触发一次该回调，报告媒体资源的相关信息。

参数

stats

媒体资源的相关信息，详见 PlayerPlaybackStats。

所属接口类

• IMediaPlayerSourceObserver