浏览器与应用环境信息

浏览器与应用环境信息

本文介绍 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 浏览器 - - 支持 支持 不支持

注意:

页面访问协议说明

浏览器厂商出于对用户安全、隐私等问题的考虑,限制网页在 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:偏好设置 -> 网站 -> 找到摄像头、麦克风、屏幕共享 -> 按提示设置即可