网络质量是影响参会体验的关键因素之一,通过平台开发者可实时获取会议网络质量数据以支持数据分析或显示。
网络质量数据通过事件回调的方式返回,根据小鱼易连产品定义规则进行了质量级别的划分,开发者可参考进行后续业务处理。
在视频会议中,通过监听本地网络质量等级:networkLevel 和远端参会者网络质量等级:networkParameter,实时获取网络质量等级信息;质量等级分为4个级别:1、2、3、4,分别对应:非常差、差、一般、很好,开发者可以监听网络质量等级,向用户提示具体的网络质量信息;
建议在网络质量差的情况下,关闭视频功能,保障音频的正常接收;
监听本地网络质量等级
/**
* 网络质量信号等级
*
* @param Bad 1 - 非常差
* @param Poor 2 - 差
* @param Good 3 - 一般
* @param Excellent 4 - 很好
*/
export enum NetworkQualityLevel {
Bad = 1,
Poor,
Good,
Excellent
}
// 监听本地网络质量等级
client.on('networkLevel', (data: NetworkQualityLevel) => {
//...
});
监听远端参会者网络质量等级
/**
* 远端网络质量信号等级
*
* @property { string } fromCallUri 远端的callUri
* @property { number } fromPid 远端的pid
* @property { NetworkQualityLevel } networkLevel 网络质量信号等级
* @property { string } toCallUri local callUri
*
*/
export interface INetworkParameter {
fromCallUri: string;
fromPid: number;
// 同上Type类型
networkLevel: NetworkQualityLevel;
toCallUri: string;
}
client.on('networkParameter', (data: INetworkParameter) => {
//...
});