流媒体与实时通信 / 系统课时

整理上线前语音检查清单

整理上线前语音检查清单

实时语音功能能在开发机上通话,不代表已经具备上线条件。上线前必须把设备、权限、协商、连接、音频处理、监控和恢复都转成可验证的门槛,才能在真实网络和真实设备上稳定运行并留下可排障证据。

学习目标

  • 能把上线检查项整理为明确的“检查方法、通过条件、失败动作”。
  • 能验证浏览器安全上下文、麦克风采集、WebRTC 连接和播放链路的基本前置条件。
  • 能为网络波动、设备变化和重连准备可观测与恢复方案。

把检查项变成发布门槛

检查清单不能只写“确认麦克风正常”这类模糊描述,而要给出可执行验证和失败后的处理动作。下面的表格适合作为预发布验收的最小集合。

环节 通过条件 验证方法 不通过时
安全与权限 页面处于安全上下文,麦克风授权路径可用 真机请求一次音频流 区分权限拒绝、系统禁用和浏览器策略
设备 默认设备可采集,热插拔后状态可恢复 切换有线、蓝牙或系统默认输入 重新枚举设备并更新当前轨道
SDP 协商 音频媒体段未被拒绝,双方存在可用编解码能力 检查 offer/answer 与连接日志 保留协商失败原因,不盲目重试
ICE/DTLS 连接可进入 connected,失败后有恢复路径 Wi-Fi、蜂窝或受限网络实测 执行 ICE restart 或完整重建会话
音频处理 回声、噪声和音量行为符合产品场景 扬声器、耳机、双讲场景试听与指标比对 先确认设备与网络,再调处理策略
播放 远端音频可被用户实际听到 校验元素状态、自动播放与输出路由 恢复播放上下文或提示用户交互
监控 故障时能关联会话、时间与关键 stats 触发一次人工故障并核对日志 补齐埋点后再放量
异常恢复 断网、切网、设备变化后可恢复或给出明确失败态 执行预设故障演练 避免无限重试,进入可诊断终态

网络质量不要使用一个“行业通用阈值”作为全部设备和网络的上线标准。更稳妥的方法是结合目标场景建立产品自己的基线,并持续记录丢包、抖动、往返时延、隐藏样本和重连耗时等指标。

运行浏览器前置检查

下面的浏览器脚本可以在 HTTPS 页面或 localhost 中执行,用来验证安全上下文、getUserMedia() 可用性和麦克风轨道状态。它会在检查后立即停止轨道,避免持续占用设备。

js
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));

预期输出

text
{
  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 增量,并为敏感字段设置最小化采集和留存规则。

用验收结果决定是否放量

真正可以放量的标准,是关键路径全部有通过条件,失败路径能够进入可解释状态,并且至少完成一次跨设备、跨网络的故障演练。任何“偶现但暂时无法记录”“只能刷新页面恢复”“失败原因只能靠用户描述”的问题,都应视为上线前的可观测性或恢复能力缺口。

最终清单应作为发布门禁持续执行:功能改动、浏览器升级、音频处理参数变化或信令服务变更后,都重新跑核心检查项,而不是只在首次上线前检查一次。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理上线前语音检查清单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通