客户端事件通知(HWLLSClientEvent)
本章节介绍了低时延直播Web SDK的HWLLSClientEvent接口详情。
接口 |
描述 |
---|---|
媒体统计事件。 |
|
网络质量报告事件。 |
|
视频断流事件。 |
|
音频断流事件。 |
|
视频断流恢复事件。 |
|
音频断流恢复事件。 |
|
音频起播事件。 |
|
视频起播事件。 |
|
视频是否停顿事件 |
|
播放视图是否全屏事件 |
|
播放降级事件 |
|
客户端出现错误事件。 |
事件注册监听应在业务结束时取消注册,否则注册监听事件累积会有内存泄漏风险。
media-statistic
【事件说明】
媒体统计事件。此事件配合streamStatistic方法使用。
【回调参数】
StatisticInfo:StatisticInfo类型,媒体统计信息。
StatisticInfo定义为:{
- video:{
frameRate:number类型,视频帧率。
width:number类型,视频宽度。
height:number类型,视频高度。
jitter:number类型,抖动值。
bitRate:number类型,码率,单位:kbps。
bytesReceived:number类型,已接收字节数。
packetsReceived:number类型,已接收包数。
packetsLost:number类型,丢包数。
}
- audio:{
jitter:number类型,抖动值。
bitRate:number类型,码率,单位:kbps。
bytesReceived:number类型,已接收字节数。
packetsReceived:number类型,已接收包数。
packetsLost:number类型,丢包数。
}
}
network-quality
【事件说明】
网络质量报告事件。
【回调参数】
NetworkQualityTypes:NetworkQualityTypes类型,网络质量详情。
NetworkQualityTypes枚举值参考如下:
- NETWORK_QUALITY_UNKNOW = 0,网络质量未知。
- NETWORK_QUALITY_GREAT = 1,网络质量极好。
- NETWORK_QUALITY_GOOD = 2,用户主观感觉和极好差不多,但码率可能略低于极好。
- NETWORK_QUALITY_DEFECTS = 3,网络质量一般,用户主观感受有瑕疵但不影响观看。
- NETWORK_QUALITY_WEAK = 4,网络质量差,勉强能观看但不流畅。
- NETWORK_QUALITY_BAD = 5,网络质量很差,严重影响用户观看体验。
- NETWORK_QUALITY_DISCONNECT = 6,网络质量非常差甚至链接断开,无法观看。
string类型,降级信息。
- webrtc:标识LLL播放模式。
- hls:标识hls播放模式。
- flv:标识flv播放模式。
Error
【事件说明】
客户端错误事件,当出现不可恢复的错误后,Client会上报该事件通知。
【回调参数】
errorInfo:必选,ErrorInfo类型,错误信息。
ErrorInfo定义为:{
errorCode:必选,string类型,错误码。
errorMsg:必选,string类型,错误描述。
}
在网络防火墙限制(UDP端口限制)或者低时延直播多次重试播放失败的场景下,可根据特定错误码(HWLLS_MEDIA_NETWORK_ERROR、HWLLS_PLAY_WEBRTC_RETRY_FAILED),进行播放降级,请参考SDK使用。