Tutorial: 检测浏览器支持性

检测浏览器支持性

浏览器支持情况概述

本文介绍 Web SDK 对浏览器的支持情况。

操作系统 浏览器类型 浏览器最低
版本要求
接收(播放) 发送(上麦) 屏幕分享 SDK 版本要求
Mac OS 桌面版 Safari 浏览器 11+ 支持 支持 支持(需要 Safari13+ 版本) -
Mac OS 桌面版 Chrome 浏览器 56+ 支持 支持 支持(需要 Chrome72+ 版本) -
Mac OS 桌面版 Firefox 浏览器 56+ 支持 支持 支持(需要 Firefox66+ 版本) v4.7.0+
Mac OS 桌面版 Edge 浏览器 80+ 支持 支持 支持 v4.7.0+
Windows 桌面版 Chrome 浏览器 56+ 支持 支持 支持(需要 Chrome72+ 版本) -
Windows 桌面版 QQ 浏览器(极速内核) 10.4+ 支持 支持 不支持 -
Windows 桌面版 Firefox 浏览器 56+ 支持 支持 支持(需要 Firefox66+ 版本) v4.7.0+
Windows 桌面版 Edge 浏览器 80+ 支持 支持 支持 v4.7.0+
iOS 11.1.2+ 移动版 Safari 浏览器 11+ 支持 支持 不支持 -
iOS 12.1.4+ 微信内嵌网页 - 支持 不支持 不支持 -
Android 移动版 QQ 浏览器 - 不支持 不支持 不支持 -
Android 移动版 UC 浏览器 - 不支持 不支持 不支持 -
Android 微信内嵌网页(TBS 内核) - 支持 支持 不支持 -
Android 微信内嵌网页(XWEB 内核) - 支持 支持 不支持 -

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

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

⚠️ 当用户使用 SDK 支持的浏览器,且收到 TRTC.checkSystemRequirements 返回的检测结果为 false 时,可能是以下原因:

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

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

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

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

Firefox

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

QQ 浏览器

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