浏览器兼容性和已知问题
- Web
更新时间不可用
查看实时互动 RTC 的浏览器兼容性和已知问题，了解关键概念、参数说明、使用限制和接入注意事项。
声网 Web SDK 是一款基于 WebRTC 技术的实时音视频 SDK，因此 WebRTC 技术的浏览器兼容性决定了声网 Web SDK 的浏览器兼容性。本文介绍声网 Web SDK 支持在哪些浏览器中使用。
桌面端
Web SDK 在桌面端的 Chrome、Firefox、Safari、Edge 等浏览器上的支持度较好。为保证最佳的用户体验，声网建议在最新版本的操作系统中使用上述浏览器的最新版本：
- 下载 Chrome 官方最新版本。
- 下载 Firefox 官方最新版本。
- 下载 Edge 官方最新版本。
- 下载 Safari 官方最新版本。
兼容性
下文列出了浏览器的最低版本要求。为获得更好的体验，声网推荐你使用最新版本的浏览器。
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Chrome | 65 或以上版本 | ✔ | ✔ | ✔ |
| Firefox | 69 或以上版本 | ✔ | ✔ | ✔ |
| Safari | 11 或以上版本 | ✔ | ✔ | ✔ （需要 Safari 13 或以上版本） |
| Edge | 无明确信息 | ✔ | ✔ | ✔ |
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Chrome | 65 或以上版本 | ✔ | ✔ | ✔ |
| Firefox | 69 或以上版本 | ✔ | ✔ | ✔ |
| Edge | 80 或以上版本 | ✔ | ✔ | ✔ |
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Chrome | 89 或以上版本 | ✔ | ✔ | ✔ |
已知问题和限制
由于各平台和应用内置浏览器的实现方式各不相同，导致支持的 Web SDK 功能也可能有所不同，因此会存在已知问题和已知限制：
- 已知问题：由特定浏览器版本的 Bug 所造成的问题。针对已知问题，声网提供规避方案。
- 已知限制：由于浏览器自身存在问题，Web SDK 无法支持的 API 或功能。
移动端
信息
自 4.6.0 起，Web SDK 优化了在移动端浏览器上的体验。如果你想提升在移动端的体验，声网强烈建议你升级到 4.x 最新版本。
兼容性
下文列出的版本为浏览器的最低版本要求。
Android 支持自研 WebView 或引入第三方 WebView，不同设备、不同应用的 WebView 可能实现不同，因此对 Web SDK 的支持与应用版本和设备硬件有关。
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Chrome | 78 或以上版本 | ✔ | ✔ | ✘ |
| 微信内置浏览器 | 微信 7.0.20 或以上版本 | ✔ | ✔ | ✘ |
| 企业微信内置浏览器 | 企业微信 3.1.6 或以上版本 | ✔ | ✔ | ✘ |
iOS 只支持系统 WebView，因此对 Web SDK 的支持只与 iOS 系统版本有关。
iOS 版本 ≥ 12.2 且 < 14.3
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Safari | 与 iOS 系统版本对应 | ✔ | ✔ | ✘ |
| Chrome | 无明确信息 | ✔ | ✘ | ✘ |
| 微信内置浏览器 | 微信 8.0.13 或以上版本 | ✔ | ✘ | ✘ |
| 企业微信内置浏览器 | 企业微信 3.1.15 或以上版本① | ✔ | ✘ | ✘ |
iOS 版本 ≥ 14.3
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| Safari | 与 iOS 系统版本对应 | ✔ | ✔ | ✘ |
| Chrome | 92 或以上版本 | ✔ | ✔ | ✘ |
| 微信内置浏览器 | 微信 8.0.13 或以上版本 | ✔ | ✔ | ✘ |
| 企业微信内置浏览器 | 企业微信 3.1.15 或以上版本① | ✔ | ✔ | ✘ |
信息
① 在企业微信内直接打开链接无法互通。需要开启麦克风和相机权限后，重启企业微信，打开链接刷新页面才能正常互通。
目前仅 Mate 60 Pro 机型支持升级至 HarmonyOS NEXT 5.0 或以上版本的鸿蒙系统，你需要在该类设备上使用华为浏览器，才能使用 Web SDK 接收和发布视频流。
| 浏览器 | 浏览器版本要求 | 接收音视频流 | 发布音视频流 | 屏幕共享 |
|---|---|---|---|---|
| 华为浏览器 | 无明确信息 | ✔ | ✔ | ✘ |
已知问题和限制
由于各平台和应用内置浏览器的实现方式各不相同，导致支持的 Web SDK 功能也可能有所不同，因此会存在已知问题和已知限制：
- 已知问题：由 iOS/Android/HarmonyOS 平台特定浏览器/机型的 Bug 所造成的问题。针对已知问题，声网提供规避方案。
- 已知限制：由于 iOS/Android/HarmonyOS 平台的问题，Web SDK 无法支持的 API 或功能。
已知问题
已知限制
检测浏览器兼容性
声网 Web SDK 提供 checkSystemRequirements 方法，用于检测 SDK 是否能在当前浏览器中使用。
const result = AgoraRTC.checkSystemRequirements();
// result 为 true 代表支持，false 代表不支持
console.log(result);