流媒体与实时通信 / 系统课时
整理上线前语音检查清单
整理上线前语音检查清单
实时语音功能能在开发机上通话,不代表已经具备上线条件。上线前必须把设备、权限、协商、连接、音频处理、监控和恢复都转成可验证的门槛,才能在真实网络和真实设备上稳定运行并留下可排障证据。
学习目标
- 能把上线检查项整理为明确的“检查方法、通过条件、失败动作”。
- 能验证浏览器安全上下文、麦克风采集、WebRTC 连接和播放链路的基本前置条件。
- 能为网络波动、设备变化和重连准备可观测与恢复方案。
把检查项变成发布门槛
检查清单不能只写“确认麦克风正常”这类模糊描述,而要给出可执行验证和失败后的处理动作。下面的表格适合作为预发布验收的最小集合。
| 环节 | 通过条件 | 验证方法 | 不通过时 |
|---|---|---|---|
| 安全与权限 | 页面处于安全上下文,麦克风授权路径可用 | 真机请求一次音频流 | 区分权限拒绝、系统禁用和浏览器策略 |
| 设备 | 默认设备可采集,热插拔后状态可恢复 | 切换有线、蓝牙或系统默认输入 | 重新枚举设备并更新当前轨道 |
| SDP 协商 | 音频媒体段未被拒绝,双方存在可用编解码能力 | 检查 offer/answer 与连接日志 | 保留协商失败原因,不盲目重试 |
| ICE/DTLS | 连接可进入 connected,失败后有恢复路径 |
Wi-Fi、蜂窝或受限网络实测 | 执行 ICE restart 或完整重建会话 |
| 音频处理 | 回声、噪声和音量行为符合产品场景 | 扬声器、耳机、双讲场景试听与指标比对 | 先确认设备与网络,再调处理策略 |
| 播放 | 远端音频可被用户实际听到 | 校验元素状态、自动播放与输出路由 | 恢复播放上下文或提示用户交互 |
| 监控 | 故障时能关联会话、时间与关键 stats | 触发一次人工故障并核对日志 | 补齐埋点后再放量 |
| 异常恢复 | 断网、切网、设备变化后可恢复或给出明确失败态 | 执行预设故障演练 | 避免无限重试,进入可诊断终态 |
网络质量不要使用一个“行业通用阈值”作为全部设备和网络的上线标准。更稳妥的方法是结合目标场景建立产品自己的基线,并持续记录丢包、抖动、往返时延、隐藏样本和重连耗时等指标。
运行浏览器前置检查
下面的浏览器脚本可以在 HTTPS 页面或 localhost 中执行,用来验证安全上下文、getUserMedia() 可用性和麦克风轨道状态。它会在检查后立即停止轨道,避免持续占用设备。
async function runAudioPreflight() {
const result = {
secureContext: window.isSecureContext,
hasGetUserMedia: Boolean(navigator.mediaDevices?.getUserMedia),
trackState: null,
trackEnabled: null,
sampleRate: null,
channelCount: null,
};
if (!result.secureContext || !result.hasGetUserMedia) {
return result;
}
const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
try {
const track = stream.getAudioTracks()[0];
const settings = track.getSettings();
result.trackState = track.readyState;
result.trackEnabled = track.enabled;
result.sampleRate = settings.sampleRate ?? null;
result.channelCount = settings.channelCount ?? null;
return result;
} finally {
stream.getTracks().forEach((track) => track.stop());
}
}
runAudioPreflight()
.then((result) => console.log(result))
.catch((error) => console.error(error.name, error.message));预期输出
{
secureContext: true,
hasGetUserMedia: true,
trackState: "live",
trackEnabled: true,
sampleRate: <SAMPLE_RATE>,
channelCount: <CHANNEL_COUNT>
}<SAMPLE_RATE> 与 <CHANNEL_COUNT> 由实际设备和浏览器决定。若用户拒绝权限,脚本会进入 catch,常见错误名是 NotAllowedError;上线逻辑应把这类可预期失败转换为明确的用户提示,而不是当成系统异常。
检查协商、连接与播放
协商阶段至少要确认本地和远端描述设置成功,音频媒体段没有被拒绝,并且实际发送的轨道与业务状态一致。连接阶段记录 iceConnectionState 与 connectionState 的关键变化,避免只记一个最终失败结果。
播放侧经常被忽略。远端已经持续收到 RTP 并不代表用户一定听得到声音,还要验证媒体元素未被静音、音量不为零、浏览器自动播放限制已处理,并且输出设备路由符合预期。移动端还应覆盖前后台切换、音频焦点变化和系统通话打断。
做一次上线前故障演练
至少覆盖四类真实故障:首次拒绝麦克风权限、通话中拔掉或切换设备、通话中从 Wi-Fi 切换到其他网络、远端断开后重新进入。每个场景都要明确“是否自动恢复、多久进入稳定状态、失败后用户看到什么”。
监控必须能把一次用户反馈还原为时间线。推荐保留不含音频内容的会话标识、浏览器与系统版本、设备变化事件、协商状态、连接状态和关键 stats 增量,并为敏感字段设置最小化采集和留存规则。
用验收结果决定是否放量
真正可以放量的标准,是关键路径全部有通过条件,失败路径能够进入可解释状态,并且至少完成一次跨设备、跨网络的故障演练。任何“偶现但暂时无法记录”“只能刷新页面恢复”“失败原因只能靠用户描述”的问题,都应视为上线前的可观测性或恢复能力缺口。
最终清单应作为发布门禁持续执行:功能改动、浏览器升级、音频处理参数变化或信令服务变更后,都重新跑核心检查项,而不是只在首次上线前检查一次。