实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频实时音视频开发指南通话前网络检测Web 端通话前网络质量检测
复制全文
下载 pdfWeb 端通话前网络质量检测
文档反馈
问问助手为提供更好的音视频通话体验，你可以在用户正式通话前进行网络质量检测，并根据检测质量的判定结果采取相应的措施。例如，降低码率，或者通过 UI 提醒用户切换到更稳定的网络环境。
前提条件
你已经实现了基础音视频通话功能。
功能实现
- 调用两次 createEngine 创建两个 Engine 实例。
- uplinkClient：用于检测发送网络通道质量
- downlinkClient：用于检测接收网络通道质量
const uplinkClient = VERTC.createEngine(appId);
const downlinkClient = VERTC.createEngine(appId);
- 在 uplinkClient 实例中调用 startVideoCapture 和 startAudioCapture 采集音视频流。
await uplinkClient.startAudioCapture();
await uplinkClient.startVideoCapture();
- 分别调用 joinRoom ，使用不同的 userId 和 token 进入同一个测试房间。
- uplinkClient：将自动发布设置为 true
- downlinkClient：将自动订阅音频/视频设置为 true
// uplinkClient 进房，设置为自动发布，开启音视频采集
uplinkClient.joinRoom(token1, roomId, { userId: userId1 }, {
isAutoPublish: true,
isAutoSubscribeAudio: false,
isAutoSubscribeVideo: false
});
// downlinkClient 进房，设置为自动订阅
downlinkClient.joinRoom(token2, roomId, { userId: userId2 }, {
isAutoPublish: false,
isAutoSubscribeAudio: true,
isAutoSubscribeVideo: true
});
- 获取上、下行网络通道质量数据。
- 自 v4.44 起，通过 onNetworkQuality 获取上、下行网络通道质量数据。
// 查看上行网络质量数据
uplinkClient.on('onNetworkQuality', (uplinkNetworkQuality) => {
console.log('onNetworkQuality: ', uplinkNetworkQuality);
});
// 查看下行网络质量数据
downlinkClient.on('onNetworkQuality', (_, downlinkNetworkQuality) => {
console.log('onNetworkQuality: ', downlinkNetworkQuality);
});
- 在 v4.43 及之前的版本中，你需要通过 onLocalStreamStats 和 onRemoteStreamStats 获取上、下行网络通道质量数据，并将得到的质量数据放在你的 QoE 模型中进行计算，最终决策出网络质量。下表给出了一个简易的网络质量判断标准。
网络质量 | 上行丢包率 LossRate | 下行端到端延迟 e2eDelay | 往返时延 rtt | 接收端卡顿率 StallDuration/2000ms |
网络质量 | 上行丢包率 LossRate | 下行端到端延迟 e2eDelay | 往返时延 rtt | 接收端卡顿率 StallDuration/2000ms |
好，可以进行音视频通话 | < 0.05 | < 600 ms | < 250 ms | < 0.15 |
较差，建议降低码率 | 0.05～0.1 | 600 ms～1200 ms | 250 ms～1000 ms | 0.15～0.3 |
很差，建议切换稳定网络 | > 0.1 | > 1200 ms | > 1000 ms | > 0.3 |
// 查看上行网络质量数据
uplinkClient.on('onLocalStreamStats', stats => {
console.log('onLocalStreamStats: ', stats);
// 查看下行网络质量数据
downlinkClient.on('onRemoteStreamStats', stats => {
console.log('onRemoteStreamStats: ', stats);
API 参考
最近更新时间：2026.08.04 14:11:04
这个页面对您有帮助吗？
有用
有用
无用
无用