版本概述
腾讯云实时音视频的 Web 与 H5 端 SDK 发布 5.19.0 版本。该版本围绕通话质量可观测性、插件使用灵活性与虚拟背景效果三个方向做了改进，并修复了若干影响体验的已知问题。对于在浏览器环境中承载音视频通话、互动直播与在线会议业务的团队，本次更新主要影响质量排查方式与前端插件的初始化策略。
新增远端用户网络质量感知
在此前的实现中，开发者主要只能观察到本端的网络状况，当通话质量下降时，很难快速判断问题出在自身网络还是对端网络，排查往往需要人工收集多方日志。本次更新在网络质量事件中新增了远端网络质量字段，开发者可以直接获取远端用户的网络质量，判断通话卡顿、延迟或音质下降是否由对端网络较差引起。
这一能力对以下几类场景价值明显：多人会议中个别参会者体验差时，可以快速定位是否为该用户的接入网络问题；在线客服与远程问诊等对通话稳定性要求高的场景，可以在界面上给出更有针对性的提示，而不是笼统地建议用户检查网络；质量运营团队也可以把远端网络质量纳入监控指标，做更细粒度的通话质量分析。
插件可在未开启麦克风或摄像头时启动
新版本支持在未开启麦克风、摄像头的情况下启动 AI 降噪、变声与水印插件。此前这些插件通常需要在采集设备已开启后才能初始化，导致前端必须在设备权限与设备状态之间做复杂的顺序控制，用户尚未开启摄像头时无法提前准备音效或水印配置。
更新后，开发者可以在进房准备阶段就完成插件初始化与参数配置，等用户真正开启设备后立即生效，从而简化初始化逻辑，减少因设备状态变化带来的插件重启与参数丢失问题。
虚拟背景效果与性能优化
本次更新对虚拟背景的效果与性能做了优化，人物边缘更加自然清晰。虚拟背景依赖实时人像分割，边缘处理的质量直接影响观感，尤其在人物快速移动、光线复杂或背景与人物颜色接近时容易出现毛边与闪烁。改善分割边缘后，在线会议、在线教育与直播等场景的画面观感更为稳定，同时也降低了前端的处理开销。
问题修复
- 修复切换分辨率时偶现的音频音量变化问题。
- 修复自动播放失败偶现无法恢复的问题。
- 修复重复更新小流分辨率导致画面闪烁的问题。
近期版本节奏与升级建议
在该版本之前，Web 与 H5 端 SDK 在 2026 年 6 月至 7 月还连续发布了多个小版本，包括新增音频播放插件、支持过滤虚拟设备、增强弱网与高延迟场景下的网络恢复能力，以及兼容更多浏览器等。整体节奏以能力增强与兼容性修复为主。官方建议业务及时更新到最新版本，以获得更好的稳定性与在线支持。
升级时建议先在测试环境验证远端网络质量字段的解析逻辑，确认与自有质量监控系统的指标口径一致；若业务使用了 AI 降噪、变声或水印插件，可以评估改为提前初始化以简化流程；涉及虚拟背景的场景建议对比升级前后的边缘效果与设备占用情况。由于浏览器兼容性差异较大，上线前应在目标浏览器与主流移动设备上进行完整回归。
