限定访问区域

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

信息

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

技术原理

开启限定访问区域功能后，不论用户在哪个区域使用你的 App，SDK 都只会访问指定区域的声网服务器。

例如你指定了北美为访问区域，假设有两位用户分别从北美和中国连接声网服务器：

指定的访问区域	App 用户所在区域	SDK 实际访问的区域	连接后的用户体验
北美	北美	北美	正常
	中国		可能受到较大影响

信息

• 如果指定区域的服务器都不可用，SDK 会直接报错。
• 由于指定区域与 App 用户所在区域之间存在跨区域公共互联网，公共互联网网络质量较差会导致音视频体验受到影响。

实现方法

你可以调用 AgoraRTC.setArea 方法来指定访问区域。默认情况下，SDK 会就近选择声网服务器进行连接。设置访问区域之后，SDK 只会连接到指定区域内的声网服务器。

目前仅支持指定单个访问区域。区域可设为：

• ASIA: 除中国大陆以外的亚洲区域。
• CHINA: 中国。
• EUROPE: 欧洲区域。
• GLOBAL: 全球。
• INDIA: 印度。
• JAPAN: 日本。
• NORTH_AMERICA: 北美区域。

参考以下示例代码：

JavaScript

AgoraRTC.setArea("ASIA");

开发注意事项

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