需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

通话前检测

  • Windows

更新时间不可用

了解实时互动 RTC 在不同平台上的通话前检测方式，包括接入流程、关键配置和平台差异。

在视频会议、在线教育、互动直播等对通信质量要求高的场景下，进行通话前检测可以帮助提前识别并排查问题，保证实时互动体验。

功能介绍

通话前检测通常可以从设备质量检测和网络质量探测两个角度开展。

  • 设备质量检测：包括检测本地麦克风、扬声器以及摄像头是否能正常工作。
  • 网络质量探测：可以向用户反馈上下行 last mile 网络的带宽、丢包、网络抖动和往返时延数据，从而判断当前网络状态是否良好。其中，last mile 指的是声网边缘服务器和终端用户设备之间通信的“最后一公里”，last mile 网络质量影响用户发送和接收音视频的流畅度和清晰度。

前提条件

在进行通话前检测之前，请确保你已在 App 中实现了基本的实时音视频功能，且 App 已获取相关设备的使用权限。请参考实现音视频互动。

实现步骤

参考以下步骤在 App 中实现通话前检测。

设备质量检测

设备质量检测的基本流程如下：

SDK 提供了 startEchoTest[3/3] 方法，用于测试网络连接和音视频设备是否正常工作。参考以下步骤实现设备质量检测：

  1. 在加入频道前，调用 startEchoTest[3/3]，并在 EchoTestConfiguration 中配置测试的对象、频道名和返回测试结果的时间间隔。
  2. 开始测试后，用户需发出声音或面对摄像头，音频或视频默认会在约 2 秒后播放出来。如果音频播放正常，则表示系统音频设备和用户上下行网络均正常；如果视频播放正常，则表示系统视频设备和用户上下行网络均正常。
  3. 获得测试结果后，调用 stopEchoTest 停止测试，然后再调用 joinChannel 加入频道。

注意

目前，使用 startEchoTest[3/3] 同时测试音频设备和视频设备可能导致测试结果出现短暂的音画不同步。

请参考以下代码实现设备检测：

C++
// 测试音频设备
void testAudioDevice() {
    EchoTestConfiguration config;
    // 开启音频设备测试
    config.enableAudio = true;
    // 关闭视频设备测试
    config.enableVideo = false;
    // 设置返回测试结果的时间间隔
    config.intervalInSeconds = m_audioEchoInterval;
    //标识测试频道
    config.channelId = "AudioEchoTestChannel";
    // 开始测试
    m_rtcEngine->startEchoTest(config);
}

// 测试视频设备
void testVideoDevice() {
    EchoTestConfiguration config;
    // 关闭音频设备测试
    config.enableAudio = false;
    // 开启视频设备测试
    config.enableVideo = true;
    // 指定用于渲染本地用户视频的视图
    config.view = m_VideoTest.GetVideoSafeHwnd();
    // 设置视频画面的期望延迟
    config.intervalInSeconds = m_videoEchoInterval;
    // 标识测试频道
    config.channelId = "VideoEchoTestChannel";
    // 开始测试
    m_rtcEngine->startEchoTest(config);
}

网络质量探测

网络质量探测的基本流程如下：

SDK 提供了 startLastmileProbeTest 方法，用于在加入频道之前探测 last mile 网络质量，并返回有关网络质量打分和网络质量统计信息。参考以下步骤进行网络质量探测：

  1. 在加入频道或切换用户角色之前，调用 startLastmileProbeTest 启动网络探测。你需要在 LastmileProbeConfig 中设置探测对象和预期最高码率。
  2. 调用该方法后，SDK 会触发以下回调：
    • onLastmileQuality：在调用 startLastmileProbeTest 方法两秒后触发。该回调通过打分反馈上下行网络质量，更贴近主观感受。
    • onLastmileProbeResult：在调用 startLastmileProbeTest 方法 30 秒后触发。该回调返回网络状况的实时统计数据，包括丢包率、网络抖动和可用带宽，更加客观。
  3. 获取网络质量统计信息后，调用 stopLastmileProbeTest 方法停止 last mile 网络检测。

请参考以下代码实现网络质量探测：

C++
// 注册回调
void onLastmileQuality(int quality) {
}
void onLastmileProbeResult(LastmileProbeResult) {
}

// 配置一个 LastmileProbeConfig 实例
LastmileProbeConfig config;
// 确认探测上行网络质量
config.probeUplink = true;
// 确认探测下行网络质量
config.probeDownlink = true;
// 期望的最高发送码率，单位为 bps，范围为 [100000,5000000]
config.expectedUplinkBitrate = 100000;
// 期望的最高接收码率，单位为 bps，范围为 [100000,5000000]
config.expectedDownlinkBitrate = 100000;
// 开始网络质量探测
m_rtcEngine->startLastmileProbeTest(config);

// 停止网络质量探测
m_rtcEngine->stopLastmileProbeTest();

参考信息

检测异常处理建议

在确保 API 正确调用的前提下，遇到检测异常时，声网推荐你参考下表采取措施：

异常现象解决方案
检测音频设备时听不到声音
  • 检查录制设备和播放设备是否正常工作、是否被其他程序占用。
  • 检查网络连接是否正常。
检测视频设备时看不到画面
  • 检查视频设备是否正常工作、是否被其他程序占用。
  • 检查网络连接是否正常。
检测到上行网络质量不佳（丢包率 > 5%；网络抖动 > 100ms）
  • 检查本地网络是否正常。
  • 通过降低分辨率或降低帧率等方法确保发布音视频流的码率不超过上行可用带宽。你可以参考视频参数推荐值和视频属性参考表进行设置。
检测到下行网络质量不佳（丢包率 > 5%；网络抖动 > 100ms）

  • 检查本地网络是否正常。

  • 通过以下方式确保本地订阅的总带宽不超过下行可用带宽：

    • 减少接收端订阅音视频流的数量或降低发送端发布音视频流的码率。
    • 在发送端启用双流模式，并在接收端申请接收小流以降低带宽消耗。
    • 接收端开启视频流回退功能。
表格内容超出当前宽度，可横向滚动查看更多列。

示例项目

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

通话前检测（Gitee）

通话前检测（GitHub）

API 参考

相关文档

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利