产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
Web
在进房之前或在通话过程中，检测用户的网络质量，可以判断用户当下的网络质量情况。若用户网络质量太差，应建议用户检查网络或尝试更换网络，以保证正常通话质量。
通话过程中的网络质量检测
const trtc = TRTC.create();trtc.on(TRTC.EVENT.NETWORK_QUALITY, event => {console.log(`network-quality, uplinkNetworkQuality:${event.uplinkNetworkQuality}, downlinkNetworkQuality: ${event.downlinkNetworkQuality}`)console.log(`uplink rtt:${event.uplinkRTT} loss:${event.uplinkLoss}`)console.log(`downlink rtt:${event.downlinkRTT} loss:${event.downlinkLoss}`)})
通话前的网络质量检测
实现流程
1. 调用
TRTC.create() 方法创建两个 TRTC，分别称为 uplinkTRTC 和 downlinkTRTC。2. 这两个
TRTC 都进入同一个房间。3. 使用
uplinkTRTC 进行推流，监听 TRTC.EVENT.NETWORK_QUALITY 事件来检测上行网络质量。4. 使用
downlinkTRTC 进行拉流，监听 TRTC.EVENT.NETWORK_QUALITY 事件来检测下行网络质量。5. 整个过程可持续 15s 左右，最后取平均网络质量，从而大致判断出上下行网络情况。
注意：
API 调用时序
代码示例
let uplinkTRTC = null; // 用于检测上行网络质量let downlinkTRTC = null; // 用于检测下行网络质量let localStream = null; // 用于测试的流let testResult = {// 记录上行网络质量数据uplinkNetworkQualities: [],// 记录下行网络质量数据downlinkNetworkQualities: [],average: {uplinkNetworkQuality: 0,downlinkNetworkQuality: 0}}// 1. 检测上行网络质量async function testUplinkNetworkQuality() {uplinkTRTC = TRTC.create();uplinkTRTC.enterRoom({roomId: 8080,sdkAppId: 0, // 填写 sdkAppIduserId: 'user_uplink_test',userSig: '', // uplink_test 的 userSigscene: 'rtc'})uplinkTRTC.on(TRTC.EVENT.NETWORK_QUALITY, event => {const { uplinkNetworkQuality } = event;testResult.uplinkNetworkQualities.push(uplinkNetworkQuality);});}// 2. 检测下行网络质量async function testDownlinkNetworkQuality() {downlinkTRTC = TRTC.create();downlinkTRTC.enterRoom({roomId: 8080,sdkAppId: 0, // 填写 sdkAppIduserId: 'user_downlink_test',userSig: '', // userSigscene: 'rtc'});downlinkTRTC.on(TRTC.EVENT.NETWORK_QUALITY, event => {const { downlinkNetworkQuality } = event;testResult.downlinkNetworkQualities.push(downlinkNetworkQuality);})}// 3. 开始检测testUplinkNetworkQuality();testDownlinkNetworkQuality();// 4. 15s 后停止检测，计算平均网络质量setTimeout(() => {// 计算上行平均网络质量if (testResult.uplinkNetworkQualities.length > 0) {testResult.average.uplinkNetworkQuality = Math.ceil(testResult.uplinkNetworkQualities.reduce((value, current) => value + current, 0) / testResult.uplinkNetworkQualities.length);}if (testResult.downlinkNetworkQualities.length > 0) {// 计算下行平均网络质量testResult.average.downlinkNetworkQuality = Math.ceil(testResult.downlinkNetworkQualities.reduce((value, current) => value + current, 0) / testResult.downlinkNetworkQualities.length);}// 检测结束，清理相关状态。uplinkTRTC.exitRoom();downlinkTRTC.exitRoom();}, 15 * 1000);
结果分析
经过上述步骤，可以拿到上行平均网络质量、下行平均网络质量。网络质量的枚举值如下所示：
数值 | 含义 |
0 | 网络状况未知，表示当前 TRTC 实例还没有建立上行/下行连接 |
1 | 网络状况极佳 |
2 | 网络状况较好 |
3 | 网络状况一般 |
4 | 网络状况差 |
5 | 网络状况极差 |
6 | 网络连接已断开 注意：若下行网络质量为此值，则表示所有下行连接都断开了 |
建议：当网络质量大于3时，应引导用户检查网络并尝试更换网络环境，否则难以保证正常的音视频通话。也可通过下述策略来降低带宽消耗：若上行网络质量大于3，则可通过 TRTC.updateLocalVideo() 接口降低码率 或 TRTC.stopLocalVideo() 方式关闭视频，以降低上行带宽消耗。若下行网络质量大于3，则可通过订阅小流（参考：开启大小流传输）或者只订阅音频的方式，以降低下行带宽消耗。
文档反馈