错误报告
下面是一些与 WebRTC 相关的错误跟踪器:
- crbug.com - 适用于 Chrome1。
- bugreporter.apple.com - 针对 Safari
- developer.microsoft.com - Edge 版
- bugzilla.mozilla.org - 适用于 Firefox。
- bugs.opera.com/wizard - 适用于 Opera。
- bugs.webrtc.org - 用于 WebRTC 原生代码。
Chrome 和 WebRTC 工程师会持续对这些数据进行分类。
如何提交良好的错误报告
操作说明
- 确定要使用的 bug 跟踪器:
- 如果您是在 Chrome 中遇到问题,请使用 Blink>WebRTC 组件提交错误。方法是选择“我是一名 Web 开发者,想要构建一些内容”和“浏览器 API 的问题”,并确保由正确的人来查看您的错误。
- 如果您是使用原生代码的开发者,请通过此链接提交 bug。
- 从以下数据点中获得尽可能多的数据。
数据点示例
- 浏览器/应用的版本
- 对于 Chrome:从 chrome://version 复制/粘贴
- 对于 WebRTC 原生代码:添加您的应用使用的分支(如主干)和 WebRTC 修订版本(如 r8207)(如果适用)
- 操作系统(Windows、Mac、Linux、Android、iOS 等)和版本(例如 Windows 7、OS X 10.9、Ubuntu 14 等)
- 硬件平台/设备型号(例如 PC、Mac、Samsung 4S、Nexus 7、iPhone 5S、iPad Air 2 等)
- 摄像头和麦克风型号及版本(如适用)
- 对于 Chrome 音频和视频设备问题,请访问 https://test.webrtc.org 运行测试。测试运行完毕后,点击顶部的错误图标,下载报告,然后将报告附加到问题跟踪器中。
- 网站网址
- 重现步骤:有关如何重现错误的详细信息。如果适用,请附加或链接到使用 HTML+JavaScript 的最小测试页面。
- 对于崩溃
- 如果您在使用 Chrome 时遇到崩溃问题,请按照这些说明添加崩溃 ID。
- 如果您在使用 WebRTC 原生代码时发生崩溃,请添加完整的堆栈轨迹。
- 对于功能问题或 ICE 问题,请在 Chrome 或原生应用中收集原生日志。
- 对于 Chrome 的连接问题,请确保在发起通话之前和通话进行期间在另一个标签页中打开 chrome://webrtc-internals。
- 展开“创建转储”部分,
- 点击“下载 PeerConnection 更新和统计信息数据”按钮。系统会提示您将转储保存到本地计算机。请将该转储附加到错误报告中。
- 如果在 Chrome 进行通话期间出现音质问题,
- 请在另一标签页中打开 chrome://webrtc-internals
- 展开“创建转储”部分,
- 填写“启用诊断录音”复选框。系统会提示您将录制内容保存到本地计算机。结束通话后,将录音附加到错误。
- 对于回声问题,请尝试从生成回声的一侧(而不是听到回声的一侧)捕获音频录制内容。例如,如果用户 A 和用户 B 正在通话,而用户 A 听到自己说话,则请从用户 B 获取音频录音。
提交安全错误
WebRTC 团队非常重视安全。如果您在 WebRTC 中发现了漏洞,即使该错误仅会影响原生 WebRTC 代码,而不会影响 Chromium,请提交 Chromium 安全错误。
最好通过 Google Chrome 版本博客上稳定版更新中的安全说明查找已修复的 Chromium 安全错误的历史记录。
您还可以在 Chromium 问题跟踪器中找到已修正的、公开显示的 Type=Bug-Security 错误。旧的原生安全错误也可以在 WebRTC 问题跟踪器中找到,不过新的安全错误不应该在此处提交(安全错误通常在修复后 14 周内公开显示)。
请注意,我们通常不会向任何分支向后合并安全修复程序,因此,如果您使用的是较早的分支,则需要负责确保相关的安全修复程序已合并。一般情况下,强烈建议用户及时了解 WebRTC' 的主分支。
在 Chrome/WebRTC 中接收有关安全错误的通知
如需获取有关 WebRTC/Chrome 中的安全错误中的活动/评论的自动通知,您通常需要针对有权访问特定错误的用户明确将其抄送:
在某些情况下,您可以访问 WebRTC 中未修复(但尚未修复)的漏洞。具体而言,您需要执行以下操作:
- 打造基于真实使用量的产品(基于 WebRTC)
- 始终采用 WebRTC 树状结构确保您的产品始终保持最新状态,
- 具有包括为产品应用 WebRTC 安全补丁程序的工作角色
- 最重要的是,承诺对错误进行严格保密,并且只与有必要知道的组织内部的人员进行分享。
如果您符合条件,可以向 security@webrtc.org 发送请求,包括说明访问理由和理由。
请注意,并非所有的崩溃、内存泄漏等错误都会被标记为 Bug-Security。您可以在安全问题的严重程度指南以及安全常见问题解答页面中详细了解哪些错误属于安全错误。