通知
本站点除 Legacy 产品与方案外，已迁移至 声网新文档中心 ，当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持
简体中文
search-icon

限定访问区域

更新时间 2021/02/25 08:27:45
本文仅适用于 Agora Web SDK 3.x 及之前版本。如果你使用 Web SDK 4.x，请查看限定访问区域。

功能描述

为适应不同国家或地区的法律法规，声网支持限定访问区域功能，实现 SDK 只访问指定区域内的声网服务器，希望将音视频和消息数据传输限定在某一区域范围内。

假设你指定北美为访问区域，SDK 只访问北美区域内的声网服务器。无法分配可用的北美区域服务器时，SDK 会报错，而不是使用其他区域服务器替代。

该功能为高级设置，适用于有访问安全限制的场景。

实现方法

Agora RTC Web SDK 从 v3.1.2 起，支持限定区域访问。一旦指定了访问区域，音视频数据将不会访问指定区域以外的服务器。

你需要在调用 createClient 方法创建客户端实例时，通过设置 ClientConfig 的中的 areaCode 参数来指定访问区域，可设为：

  • ASIA: 除中国大陆以外的亚洲区域。
  • CHINA: 中国大陆。
  • EUROPE: 欧洲。
  • GLOBAL: 全球。
  • INDIA: 印度。
  • JAPAN: 日本。
  • NORTH_AMERICA: 北美。
  • 访问区域限制为全局设置，对整个标签页生效，即只要一个 Client 设置了访问区域，同页面创建的其他 Client 均会遵守访问区域限制。
  • 仅支持指定单个访问区域。

示例代码

var config = {
    mode: "live",
    codec: "vp8",
    // 指定仅访问北美的服务器。
    areaCode: [AgoraRTC.AREAS.NORTH_AMERICA]
};
// 创建客户端实例。
var client = AgoraRTC.createClient(config);

开发注意事项

如果你的网络环境部署了防火墙，使用该功能还需要根据应用企业防火墙限制将对应的域名添加到防火墙白名单，不对 IP 地址设限，且开放相应端口。