Client Event Notification (HWLLSClientEvent)

media-statistic

[Event Description]

Media statistics event. This event is used together with the streamStatistic method.

[Callback Parameters]

StatisticInfo: media statistics. The value type is StatisticInfo.

StatisticInfo is defined as follows: {

• video: {

  mediaType: media type

  frameRate: video frame rate. The type is number.

  width: video width. The type is number.

  height: video height. The type is number.

  jitter: jitter. The type is number.

  bitRate: bitrate (in kbit/s). The type is number.

  bytesReceived: number of received bytes. The type is number.

  packetsReceived: number of received packets. The type is number.

  packetsLost: number of lost packets. The type is number.

  }

• audio: {

  mediaType: media type

  jitter: jitter. The type is number.

  bitRate: bitrate (in kbit/s). The type is number.

  bytesReceived: number of received bytes. The type is number.

  packetsReceived: number of received packets. The type is number.

  packetsLost: number of lost packets. The type is number.

  }

}

network-quality

[Event Description]

Network quality report event.

[Callback Parameters]

NetworkQualityTypes: network quality details. The type is NetworkQualityTypes.

The enumerated values of NetworkQualityTypes are as follows:

• NETWORK_QUALITY_UNKNOW = 0: The network quality is unknown.
• NETWORK_QUALITY_GREAT = 1: The network quality is excellent.
• NETWORK_QUALITY_GOOD = 2: User experience is almost the same as that of value 1, but the bitrate may be slightly lower.
• NETWORK_QUALITY_DEFECTS = 3: User experience is defective but the watching is not affected.
• NETWORK_QUALITY_WEAK = 4: The network quality is poor and the video is not smooth.
• NETWORK_QUALITY_BAD = 5: The network quality is so poor that user experience is severely affected.
• NETWORK_QUALITY_DISCONNECT = 6: The network quality is poor and even disconnection occurs. The video cannot be watched.

video-broken

[Event Description]

Video streaming interruption event (waiting for recovery).

[Callback Parameters]

None

audio-broken

[Event Description]

Audio streaming interruption event (waiting for recovery).

[Callback Parameters]

None

video-recovery

[Event Description]

Video streaming resumption (non-EOF) event (playback resumed).

[Callback Parameters]

None

audio-recovery

[Event Description]

Audio streaming resumption (non-EOF) event (playback resumed).

[Callback Parameters]

None

audio-start

[Event Description]

Audio playback start event.

[Callback Parameters]

None

video-start

[Event Description]

Video playback start event.

[Callback Parameters]

None

video-stuck

[Event Description]

Video playback pause event.

[Callback Parameters]

Boolean value. True indicates paused, and False indicates not paused.

fullscreen-status-changed

[Event Description]

Full-screen view event.

[Callback Parameters]

• isFullScreen: indicates whether to enable full-screen display
• isPause: indicates whether to stop playback

player-changed

[Event Description]

Playback downgrade event.

[Callback Parameters]

Error

[Event Description]

This event is triggered when an unrecoverable client error occurs.

[Callback Parameters]

errorInfo: (mandatory) error information. The value is of the HwLLSError type.

errorInfo is defined as: {

code: (mandatory) error code. The type is number.

message: (mandatory) error description. The type is string.

getCode (): (mandatory) returned error code. The type is number.

getMsg (): (mandatory) returned error description. The type is string.

}

CAUTION:

If the network firewall is restricted (UDP port restriction) or playback fails on LLL for multiple times, you can downgrade the playback based on the specified error code (HWLLS_MEDIA_NETWORK_ERROR or HWLLS_PLAY_WEBRTC_RETRY_FAILED). For details, see SDK Usage.