音视频观测器
- HarmonyOS
更新时间不可用
registerPlayerObserver
注册一个播放观测器。
public abstract registerPlayerObserver(playerObserver:IMediaPlayerObserver);调用时机
加入频道前后均可调用。
调用限制
无。
参数
| 参数名 | 描述 |
|---|---|
playerObserver | 播放观测器，报告播放中的事件，详见 IMediaPlayerObserver。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
unRegisterPlayerObserver
取消注册播放观测器。
public abstract unRegisterPlayerObserver();参数
| 参数名 | 描述 |
|---|---|
playerObserver | 播放观测器，报告播放中的事件，详见 IMediaPlayerObserver。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
onAudioVolumeIndication
媒体播放器音量提示回调。
onAudioVolumeIndication?:(volume:number) => void详情
SDK 每 200 毫秒触发一次该回调，报告媒体播放器当前的音量。
参数
所属接口类
onMetaData
报告已获取媒体附属信息。
onMetaData?:(type:Constants.MediaPlayerMetadataType,data:ArrayBuffer) => void详情
解析媒体附属信息后时，SDK 会触发该回调，报告媒体附属信息的数据类型和具体数据。
参数
| 参数名 | 描述 |
|---|---|
type | 媒体附属信息数据类型，详见 MediaPlayerMetadataType。 |
data |
所属接口类
onPlayBufferUpdated
报告当前缓冲数据能播放的时间。
onPlayBufferUpdated?:(playCachedBuffer:number) => void详情
播放在线媒体资源的过程中，SDK 会每隔 1 秒触发一次该回调，报告当前缓冲的数据能支持的播放时间。
- 当缓冲数据支持的播放时间小于阈值（默认为 0）时，返回 BUFFER_LOW (6)。
- 当缓冲数据支持的播放时间大于阈值（默认为 0）时，返回 BUFFER_RECOVER (7)。
参数
所属接口类
onPlayerEvent
报告播放器的事件。
onPlayerEvent?:(eventCode:Constants.MediaPlayerEvent,elapsedTime:number,message:string) => void详情
- 调用 seek 定位播放后，SDK 会触发该回调，报告定位播放的结果。
参数
| 参数名 | 描述 |
|---|---|
eventCode | 播放器事件，详见 MediaPlayerEvent。 |
elapsedTime | |
message |
所属接口类
onPlayerInfoUpdated
媒体播放器相关信息发生改变回调。
onPlayerInfoUpdated?:(info:PlayerUpdatedInfo) => void详情
当媒体播放器相关信息发生改变时，SDK 会触发该回调。你可用其进行问题定位和排查。
参数
| 参数名 | 描述 |
|---|---|
info | 媒体播放器相关信息。详见 PlayerUpdatedInfo。 |
所属接口类
onPlayerStateChanged
报告播放器状态改变。
onPlayerStateChanged?:(state:Constants.MediaPlayerState,reason:Constants.MediaPlayerReason) => void详情
当播放器状态改变时，SDK 会触发该回调，报告新的播放状态。
参数
| 参数名 | 描述 |
|---|---|
state | 新的播放状态，详见 MediaPlayerState。 |
reason | 播放器状态改变的原因，详见 MediaPlayerReason。 |
所属接口类
onPlayerSrcInfoChanged
媒体资源视频码率变化回调。
onPlayerSrcInfoChanged?:(from:SrcInfo,to:SrcInfo) => void参数
所属接口类
onPositionChanged
报告当前媒体资源的播放进度。
onPositionChanged?:(positionMs:number,timestampMs:number) => void详情
播放媒体文件时，SDK 每隔 1 秒会自动触发该回调，报告当前播放进度。
参数
所属接口类
onPreloadEvent
报告预加载媒体资源的事件。
onPreloadEvent?:(src:string,event:Constants.MediaPlayerPreloadEvent) => void参数
| 参数名 | 描述 |
|---|---|
event | 预加载媒体资源时发生的事件。详见 MediaPlayerPreloadEvent。 |