Agora Web SDK 支持所有主流浏览器,支持的浏览器及平台如下。

平台 Chrome 58+ Firefox 56+ Safari 11+ Opera 45+ QQ 浏览器 10.5+ 360 安全浏览器 微信浏览器
Android 4.1+ [1] N/A
iOS 11+ [2]
macOS 10+
Windows 7+ N/A
[1] Android Chrome 对 H.264 的支持依赖硬件,部分 Android 设备不支持 H.264 编解码。
[2] iOS Safari 上存在较多已知问题,Agora 不推荐使用。你可以使用 Agora iOS SDK 在 iOS 上实现实时音视频功能。
以下场景中请务必将 Agora Web SDK 升级至最新版本:
  • iOS 12.1.4 及以上版本使用 Safari 浏览器。
  • macOS 上使用 Safari 12.1 及以上版本。
  • 除上表浏览器外,还有以下支持:

    • Agora Web SDK 2.5 及以上版本支持 Windows XP 平台的 Chrome 49 版本浏览器(仅支持 VP8 编解码,不能与 Native SDK 互通)。
    • Agora Web SDK 2.7 及以上版本支持 Windows 10 平台的 Edge 浏览器,详见 Edge 浏览器支持
    • Agora Web SDK 理论上还支持 360 极速浏览器,但未经过验证,不保证全部功能正常工作。

    由于浏览器的差异,在不同浏览器及平台上支持的功能可能不同。下面列出浏览器和平台的已知问题和限制。

    使用限制

    Chrome 81 及以上版本、Safari 和 Firefox 浏览器需要在获得媒体设备权限后才能获取设备 ID,详见为什么在 Chrome 81 浏览器上无法获取设备 ID?

    Chrome

    Agora Web SDK 是基于 WebRTC 实现的采集和编解码,而 Chrome 又是第一批支持 WebRTC 的先行者,所以在 Chrome 上的限制最少,已知限制:

    • Chrome 版本要求 58 及以上。
    • 部分 Android 设备上,Chrome 不支持 H.264 编解码格式。
    • 部分 API 需要 Chrome 更高版本支持,具体见 API 参考内的描述。
    • 在所有使用 AMD 芯片和部分使用 Intel 芯片的 Windows 设备上,Chrome 使用 H.264 编码时,发送码率可能达不到设定值。你可以使用 VP8 编码或者尝试关闭硬件加速。

    Safari

    iOS Safari

    以下为 iOS 平台 Safari 的已知问题和限制:

    • 语音路由随机切换,即可能出现插着耳机但是仍然从扬声器出声,或者没有耳机却从听筒出声的情况。
    • iOS 13 上可能出现远端用户音量随机变化的问题。
    • 不支持 setAudioLevel 方法。
    • 连续两次调用 getUserMedia 获取相同媒体类型的轨道,第一次获取的媒体轨道会静音或黑屏。
    • 偶现问题:使用过其他使用音视频输入设备的 app 后(例如 Siri 或者 Skype 通话),无法采集本地音频或视频。
    • 偶现问题:音频会话(Audio Session)中断后(包括 mute、unmute、唤醒 Siri、接听电话等),听不到远端用户的声音。

    其他限制

    以下为 iOS 和 macOS 平台 Safari 的已知问题和限制:

    • Safari 11 只支持 480P 及以上分辨率。
    • Safari 12.1 及之前版本仅支持 H.264 编解码格式。
    • Safari 13 的用户可能听不到远端用户的声音。
    • 设备权限限制:
      • Safari 无法获取输出设备信息,因此不支持 getPlayoutDevicessetAudioOutput 这两个方法。
      • 如果 Safari 没有打开自动播放(如下图所示),直接播放音视频流会听不到声音,必须在播放前调用 navigator.mediaDevices.getUserMedia 方法获取设备权限。
    • Safari 不支持 addTrackremoveTrack
    • Safari 不支持开启双流模式

    Firefox

    • 如果 Web 端使用 Firefox 浏览器,Native 端使用 iOS 设备,Firefox 看到的视频方向会发生旋转。
    • Firefox 只支持视频帧率设为 30 fps。
    • 在部分设备上 Firefox 设置视频编码配置不生效,目前已知有此问题的设备如下:
      • MacBook Pro (13-inch, 2016, Two Thunderbolt 3 ports)
      • Windows 10 (MI)

    Edge

    Agora Web SDK 2.7 及以上版本支持 Edge 浏览器。受浏览器自身限制,仅支持以下功能:

    • 与 Agora RTC SDK 音视频互通。
    • 调用 getStats 方法获取音视频流的连接数据(受浏览器更新的影响,可能存在部分字段缺失的情况)。
    • 调用 getAudioLevel 方法获取当前音量。
    • 调用 muteAudiounmuteAudio 方法禁用或启用音频轨道。
    • 调用 muteVideounmuteVideo 方法禁用或启用视频轨道。
    • 调用 setVideoProfile 方法设置视频属性。

    相关链接

    移动端如何使用 Agora Web SDK?