VeLivePlayerObserver

类型：interface

播放器事件回调。

onError

播放器错误信息回调，播放器出现错误时，触发回调。

类型

((player: VeLivePlayer, error: VeLivePlayerError) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• error

  类型：VeLivePlayerError

  错误信息，详情请参见 VeLivePlayerError。

onFirstVideoFrameRender

视频首帧渲染事件回调。视频首帧渲染成功，或播放过程中发生重试，重试后的第一个视频帧渲染成功，均会触发此回调。

类型

((player: VeLivePlayer, isFirstFrame: boolean) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• isFirstFrame

  类型：boolean
  渲染成功的是否为视频首帧。

  • true：视频首帧。
  • false：重试后第一个视频帧。

onFirstAudioFrameRender

音频首帧渲染事件回调。音频首帧渲染成功，或播放过程中发生重试，重试后的第一个音频帧渲染成功，均会触发此回调。

类型

((player: VeLivePlayer, isFirstFrame: boolean) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• isFirstFrame

  类型：boolean
  渲染成功的是否为音频首帧。

  • true：音频首帧。
  • false：重试后第一个音频帧。

onStallStart

播放卡顿开始回调。

类型

((player: VeLivePlayer) => void) | undefined

参数

player

类型：VeLivePlayer

触发该事件回调的播放器对象。

onStallEnd

播放卡顿结束回调。音频缓冲区达到起播条件且开始播放后，触发此回调。

类型

((player: VeLivePlayer) => void) | undefined

参数

player

类型：VeLivePlayer

触发该事件回调的播放器对象。

onVideoRenderStall

视频渲染卡顿回调。视频渲染发生卡顿时，触发此回调。

类型

((player: VeLivePlayer, stallTime: number) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• stallTime

  类型：number

  视频渲染卡顿时长，单位为 ms。

onAudioRenderStall

音频渲染卡顿回调。音频渲染发生卡顿时，触发此回调。

类型

((player: VeLivePlayer, stallTime: number) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• stallTime

  类型：number

  音频渲染卡顿时长，单位为 ms。

onResolutionSwitch

清晰度档位变化回调。

类型

((player: VeLivePlayer, resolution: VeLivePlayerResolution, error: VeLivePlayerError, reason: VeLivePlayerResolutionSwitchReason) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• resolution

  类型：VeLivePlayerResolution

  切换后的清晰度档位，详情请参见 VeLivePlayerResolution。

• error

  类型：VeLivePlayerError

  切换清晰度档位时，是否发生错误，详情请参见 VeLivePlayerError。

• reason

  类型：VeLivePlayerResolutionSwitchReason

  清晰度档位切换的原因，详情请参见 VeLivePlayerResolutionSwitchReason。

onVideoSizeChanged

视频分辨率变化回调。视频大小发生变化时，触发回调。

类型

((player: VeLivePlayer, width: number, height: number) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• width

  类型：number

  变化后的视频宽度，单位为 px。

• height

  类型：number

  变化后的视频高度，单位为 px。

onReceiveSeiMessage

SEI 信息回调。当播放器 SDK 接收到 SEI 信息时，触发回调。

类型

((player: VeLivePlayer, message: string) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• message

  类型：string

  SEI 信息。

onMainBackupSwitch

主备流切换回调。

类型

((player: VeLivePlayer, streamType: VeLivePlayerStreamType, error: VeLivePlayerError) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• streamType

  类型：VeLivePlayerStreamType

  切换后的流类型为主路流或备路流，详情请参见 VeLivePlayerStreamType。

• error

  类型：VeLivePlayerError

  触发主备流切换的原因，详情请参见 VeLivePlayerError。

onPlayerStatusUpdate

播放状态发生变化时，触发回调。

类型

((player: VeLivePlayer, status: VeLivePlayerStatus) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• status

  类型：VeLivePlayerStatus

  当前播放器的状态，详情请参见 VeLivePlayerStatus。

onStatistics

播放信息周期性回调。播放器 SDK 会周期性地回调本方法，您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。
类型

((player: VeLivePlayer, statistics: VeLivePlayerStatistics) => void) | undefined

参数

• player

  类型：VeLivePlayer

  触发该事件回调的播放器对象。

• statistics

  类型：VeLivePlayerStatistics

  播放器周期性回调的统计信息，详情请参见 VeLivePlayerStatistics。