本地语音环回测试
功能介绍
本地语音环回测试用于在入会成功后快速验证本端麦克风与扬声器是否工作正常。开启后,本端麦克风采集的声音会经 SDK 直接回放到本端扬声器,您能听到自己说话的声音,从而确认设备与音频通路是否正常。
使用前提:环回测试只能在入会成功后进行,入会前调用将无法生效。
测试期间的行为说明:
- 环回测试时,本端将听不到房间中其他人的声音;
- 房间中其他人也听不到本端的声音;
- 环回测试期间会临时关闭 AEC(回声消除),以便能清晰听到本端回放;停止环回测试后将恢复原有 3A 配置;
- 适合在入会后、或会议中切换麦克风/扬声器后做一次自检。
1. 开始环回测试
在需要自检时调用 startEchoTest() 即可开始本地语音环回测试。调用成功后,对着麦克风说话即可在扬声器中听到自己的声音。
- 调用示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
CRVSDK_ERR_DEF err = meeting.startEchoTest();
if (err == CRVSDKERR_NOERR)
{
// 开始成功,可提示用户“正在环回测试,请对着麦克风说话”
}
else
{
// 可根据 err 做错误提示
}
相关 API 请参考:
2. 停止环回测试
自检完成后应调用 stopEchoTest() 结束环回测试,恢复正常听房间声音及向房间发送本端声音。
- 调用示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
meeting.stopEchoTest();
// 停止后即可正常与房间内其他成员互通
相关 API 请参考:
3. 查询是否在环回测试中
可通过 isEchoTesting() 判断当前是否处于本地语音环回测试状态,用于 UI 展示(如高亮“正在测试”状态)或逻辑判断。
- 调用示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
bool testing = meeting.isEchoTesting();
if (testing)
{
// 当前在环回测试中,可显示“正在测试”或禁用某些操作
}
相关 API 请参考:
4. 使用注意事项
- 调用线程:上述接口均非线程安全,请在 SDK 主线程中调用。
- 与 3A 的关系:环回测试会临时关闭 AEC(回声消除),以便能听到本端回放;停止环回测试后 AEC 配置会恢复。环回仅用于设备与通路自检,不影响实际会议中的 3A 效果。
- 与变声的关系:变声为服务器端实现,本地环回测试时听到的声音为未变声效果;实际会议中变声仍按 setVoiceChange 等配置生效。
- 建议流程:入会成功后(或会议中切换麦克风/扬声器后)调用 startEchoTest(),用户确认能听到自己的声音后再调用 stopEchoTest(),恢复正常与房间互通。