本文介绍 Web SDK 对浏览器的支持情况,以及访问协议限制和防火墙限制的处理建议。
浏览器兼容信息
操作系统 | 浏览器类型 | 浏览器最低 版本要求 |
SDK 版本要求 | 接收(拉流) | 发送(推流) | 屏幕分享 |
---|---|---|---|---|---|---|
Windows | 桌面版 Chrome 浏览器 | 56+ | - | 支持 | 支持 | 支持 Chrome72+ 版本 |
桌面版 QQ 浏览器(极速内核) | 10.4+ | - | 支持 | 支持 | 不支持 | |
桌面版 Firefox 浏览器 | 56+ | v4.7.0+ | 支持 | 支持 | 支持 Firefox66+ 版本 | |
桌面版 Edge 浏览器 | 80+ | v4.7.0+ | 支持 | 支持 | 支持 | |
桌面版搜狗浏览器(高速模式) | 11+ | v4.7.0+ | 支持 | 支持 | 支持 | |
桌面版搜狗浏览器(兼容模式) | - | - | 不支持 | 不支持 | 不支持 | |
桌面版 Opera 浏览器 | 46+ | v4.7.0+ | 支持 | 支持 | 支持 Opera60+ 版本 | |
桌面版 360 安全浏览器(极速模式) | 13+ | v4.7.0+ | 支持 | 支持 | 支持 | |
桌面版 360 安全浏览器(兼容模式) | - | - | 不支持 | 不支持 | 不支持 | |
桌面版微信内嵌浏览器 | - | - | 支持 | 不支持 | 不支持 | |
桌面版企业微信内嵌浏览器 | 4.0.8+(企业微信版本) | - | 支持 | 支持 | 不支持 | |
Mac OS | 桌面版 Safari 浏览器 | 11+ | - | 支持 | 支持 | 支持 Safari13+ 版本 |
桌面版 Chrome 浏览器 | 56+ | - | 支持 | 支持 | 支持 Chrome72+ 版本 | |
桌面版 Firefox 浏览器 | 56+ | v4.7.0+ | 支持 | 支持 | 支持 Firefox66+ 版本(注意[3]) | |
桌面版 Edge 浏览器 | 80+ | v4.7.0+ | 支持 | 支持 | 支持 | |
桌面版 Opera 浏览器 | 46+ | v4.7.0+ | 支持 | 支持 | 支持 Opera60+ 版本 | |
桌面版微信内嵌浏览器 | - | - | 支持 | 不支持 | 不支持 | |
桌面版企业微信内嵌浏览器 | 4.0.8+(企业微信版本) | - | 支持 | 支持 | 不支持 | |
Android | 微信内嵌浏览器(TBS 内核) | - | - | 支持 | 支持 | 不支持 |
微信内嵌浏览器(XWEB 内核) | - | - | 支持 | 支持 | 不支持 | |
企业微信内嵌浏览器 | - | - | 支持 | 支持 | 不支持 | |
移动版 Chrome 浏览器 | - | - | 支持 | 支持 | 不支持 | |
移动版 QQ 浏览器 | - | - | 不支持 | 不支持 | 不支持 | |
移动版 UC 浏览器 | - | - | 不支持 | 不支持 | 不支持 | |
iOS 12.1.4+ | 微信内嵌浏览器 | - | - | 支持 | 不支持 | 不支持 |
iOS 14.3+ | 微信内嵌浏览器 | 6.5+(微信版本) | - | 支持 | 支持 | 不支持 |
iOS | 企业微信内嵌浏览器 | 4.0.8+(企业微信版本) | - | 支持 | 支持 | 不支持 |
iOS 11.0+ | 移动版 Safari 浏览器 | 11+ | - | 支持 | 支持 | 不支持 |
iOS 12.1.4+ | 移动版 Chrome 浏览器 | - | - | 支持 | 不支持 | 不支持 |
iOS 14.3+ | 移动版 Chrome 浏览器 | - | - | 支持 | 支持 | 不支持 |
注意:
- 其他的浏览器环境可以打开 TRTC 检测页面 查看能力支持情况。
- Mac Firefox 屏幕分享可能会出现视频部分区域错位,Firefox bug。暂无法规避,建议使用 Chrome or Safari 浏览器进行屏幕分享。
- WebRTC 已知问题及规避方案。
- 由于 H.264 版权限制,华为 Chrome 88 以下版本,无法使用 H264 编码(即无法推流)。如果您希望在华为设备 Chrome 浏览器中,使用 TRTC Web SDK 推流,请提交 腾讯云实时音视频 Web SDK 用户能力支持申请 开通 VP8 编解码能力。
- 如果您希望 Web 端在推流时支持双声道编码,请提交 腾讯云实时音视频 Web SDK 用户能力支持申请 开通 WebRTC 双声道编码能力。
- 建议您及时将 TRTC Web SDK 更新至最新版本,以便获得更好的产品稳定性及在线支持。版本升级注意事项请参见:升级指引。
页面访问协议说明
浏览器厂商出于对用户安全、隐私等问题的考虑,限制网页在 https 协议下才能正常使用 TRTC Web SDK(WebRTC)的全部功能。为确保生产环境用户顺畅接入和体验 TRTC Web SDK 的全部功能,请使用 https 协议访问音视频应用页面。
注:本地开发可以通过 http://localhost 或者 file:// 协议进行访问。
URL域名及协议支持情况请参考如下表格:
应用场景 | 协议 | 接收(拉流) | 发送(推流) | 屏幕分享 | 备注 |
---|---|---|---|---|---|
生产环境 | https协议 | 支持 | 支持 | 支持 | 推荐 |
生产环境 | http协议 | 支持 | 不支持 | 不支持 | |
本地开发环境 | http://localhost | 支持 | 支持 | 支持 | 推荐 |
本地开发环境 | http://127.0.0.1 | 支持 | 支持 | 支持 | |
本地开发环境 | http://[本机IP] | 支持 | 不支持 | 不支持 | |
本地开发环境 | file:// | 支持 | 支持 | 支持 |
注意:
- 如果您的开发环境无法通过localhost访问,也没有 https 协议,建议您使用反向代理工具,将某个 https 域名的访问请求代理到您的开发环境,例如:whistle,fiddler
应对防火墙策略
若用户处于受限网络(例如带有防火墙的企业内网),使用 TRTC Web SDK 可能会受防火墙限制导致无法正常通话。此时您需要在防火墙中,为如下域名及端口配置白名单:
防火墙端口如下表所示:
类型 | 白名单端口 |
---|---|
TCP 端口 | 8687 |
UDP 端口 | 8000, 8080, 8800, 843, 443, 16285 |
域名白名单:
*.rtc.qq.com
yun.tim.qq.com
参考:应对防火墙策略限制。
设备授权说明
由于操作系统和浏览器的隐私保护策略规定,在浏览器里进行音视频通话,需要在浏览器里获得摄像头、麦克风对授权。设备授权分为两部分:
步骤 1: 操作系统允许浏览器使用摄像头、麦克风设备
Windows 和 Mac 的设置路径如下:
Windows: Windows设置 -> 隐私 -> 摄像头(或者麦克风)-> 允许桌面应用访问你的相机(或者麦克风)
Mac:系统偏好设置 -> 安全性与隐私 -> 隐私 -> 摄像头(或者麦克风、屏幕录制)-> 允许您的浏览器访问您的摄像头(或者麦克风、屏幕录制)
步骤2: 浏览器允许应用页面使用摄像头、麦克风设备
浏览器会根据域名进行授权设备的使用权,当 SDK 获取采集设备时,如果没有授权就会弹出授权对话框,需要点击允许才可以进行音视频通话。
- 不同浏览器的对话框是不一样的,这是浏览器内置对话框,目前不支持定制,已知的部分浏览器对话框如下:
桌面端 chrome:
桌面端 Safari:
Android 微信、Chrome:
iOS 微信、Safari:
- iOS 的浏览器每次都会询问是否授权,目前不支持设置默认授权。
- 在移动端如果选择了禁止授权,通常情况下刷新页面不会重新弹出授权对话框,需要关闭页面,甚至关闭浏览器重新打开页面才能弹出授权对话框。
- 在桌面端如果选择了禁止授权,则需要进入浏览器的设置窗口进行设置,设置路径如下:
Chrome:点击 URL 前面的安全锁会看到以下界面,按提示设置即可
Safari:偏好设置 -> 网站 -> 找到摄像头、麦克风、屏幕共享 -> 按提示设置即可
版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可。