浏览器兼容性

编辑文档更新于 2024-11-11 06:14:32

BRTC Web SDK 是基于 WebRTC 实现音视频通信的,因此依赖于浏览器对 WebRTC 的支持。尽管主流的浏览器都支持 WebRTC,但是由于平台和一些应用内置浏览器的实现各不相同,所以音视频编解码的支持情况比较复杂,本文简单介绍浏览器对各种应用场景下对发送和接收音视频流的支持。

平台	浏览器最低版本要求
Windows 7+	Chrome 60+ Firefox 56+ Opera 50+ Edge 浏览器 79+ QQ 浏览器 10+ 360 安全浏览器 10+ 360 极速浏览器 12+
macOS 10+	Chrome 60+ Firefox 56+ Opera 50+ Edge 浏览器 79+ 苹果 Safari 11+
Android 5.0+	Chrome 60+ 华为浏览器 10+ 微信公众号/微信浏览器 7+ 内嵌 WebView 的应用（部分设备）
iOS 11+	苹果 Safari 11+ 微信公众号/微信浏览器 7+（仅支持接收） Chrome 60+（仅支持接收）内嵌 WebView 的应用（仅支持接收）
iOS 14.3+	苹果 Safari 11+ 微信公众号/微信浏览器 7+ Chrome 60+ 内嵌 WebView 的应用

iOS 14.3 以下的系统有限制，仅允许苹果 safari 浏览器使用麦克风、摄像头设备，不允许其他浏览器使用麦克风、摄像头设备，因此 iOS 14.3以下的系统中的微信浏览器、谷歌 Chrome 浏览器中无法发布音视频流，仅支持接收音视频流
iOS 14.3 及以上的系统放开了设备权限，除了苹果 safari 浏览器，其他浏览器如微信浏览器、谷歌 Chrome 浏览器，可以申请麦克风、摄像头设备的使用权限，因此 iOS 14.3 及以上的系统中的微信浏览器、谷歌 Chrome 浏览器可以支持发布音视频流

iOS平台的兼容性

iOS 平台上所有的应用内置浏览器只能使用系统提供的 WebView，iOS 14.3 以下版本不支持发布音视频流，仅支持接收，iOS 14.3及以上版本支持发布音视频流

浏览器	VP8	H.264
Safari 浏览器（支持发送和接收）	iOS 12.2 及以后版本	iOS 11 及以后版本
微信公众号/微信浏览器 7+（支持发送和接收）	iOS 14.3 及以后版本	iOS 14.3 及以后版本
Chrome 60+（支持发送和接收）	iOS 14.3 及以后版本	iOS 14.3 及以后版本
内嵌 WebView 的应用（支持发送和接收）	iOS 14.3 及以后版本	iOS 14.3 及以后版本
微信公众号/微信浏览器 7+（仅支持接收）	iOS 12.2 及以后版本	iOS 12.1.4 及以后版本
Chrome 60+（仅支持接收）	iOS 12.2 及以后版本	iOS 12.1.4 及以后版本
内嵌 WebView 的应用（仅支持接收）	iOS 12.2 及以后版本	iOS 12.1.4 及以后版本

Android平台的兼容性

安卓平台原生的 WebView 支持自定义,因此不同设备、不同应用的 WebView 实现可能不同。
下面列出三种浏览器对编解码格式的支持：

浏览器	VP8	H.264
Chrome 60+	支持发送和接收	部分设备支持发送和接收
微信公众号/微信浏览器 7+	支持发送和接收	部分设备支持发送和接收
内嵌 WebView 的应用	部分设备支持发送和接收	部分设备支持发送和接收

在调用 SDK 的通信能力之前，建议您先使用 checkSystemSupport() 接口检测 SDK 是否支持当前网页
如果 SDK 不支持当前浏览器，请根据用户设备类型建议用户使用 SDK 支持的浏览器

BRTC.checkSystemSupport().then(checkResult => {
  if (!checkResult.result) {
    console.log('checkResult', checkResult.result, 'checkDetail', checkResult.detail);
    // 根据用户设备类型建议用户使用 SDK 支持的浏览器
  }
})

当用户使用 checkSystemSupport() 返回的检测结果为 false 时，可能是以下原因：

情况一：请检查链接是否满足以下三种情况之一

localhost 域（ Firefox 浏览器支持 localhost 及本地 ip 访问）
开启了 HTTPS 的域
使用 file:/// 协议打开的本地文件

情况二：Firefox 浏览器安装完成后需要动态加载 H264 编解码器，因此会出现短暂的检测结果为 false 的情况，请稍等再试或先使用其他推荐浏览器打开链接

已知的浏览器使用限制说明

Firefox

Firefox 只支持视频帧率为 30 fps, 如有帧率设置需求，请使用 SDK 支持的其他浏览器。

QQ 浏览器

个别摄像头，麦克风正常的 Windows 设备在 localhost 环境下调用 localStream.init() 时抛出 NotFoundError 错误

不兼容平台的处理

对于不兼容webrtc的浏览器,可以通过旁路推流,拉取 flv 音视频流来降级兼容

BRTC 浏览器兼容测试页面

BRTC 浏览器兼容测试页面