区域访问限制

为适应不同国家或地区的法律法规，声网支持限定访问区域功能。开启限定访问区域功能后，不论用户在哪个区域使用你的 app，SDK 都只会访问指定区域的声网服务器。

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

指定访问区域	App 用户所在区域	SDK 实际访问区域	连接后的用户体验
北美	北美	北美	正常
北美	中国	北美	可能受到较大影响。由于指定区域与 app 用户所在区域之间存在跨区域公共互联网，公共互联网网络质量较差会导致音视频体验受到影响。 如果指定区域的服务器都不可用，SDK 会直接报错。

信息

• 如果指定区域的服务器都不可用，SDK 会直接报错。
• 区域访问限制是 SDK 的高级设置功能，声网建议你仅在有访问安全限制的场景使用。

实现方法

服务端 SDK 支持限定区域访问。一旦指定了访问区域，音视频和消息数据将不会访问指定区域以外的服务器。

你需要在调用 initialize 方法初始化 agoraservice 包时，通过设置 AgoraServiceConfig 中的 AreaCode 参数来指定访问区域。

• AreaCodeGlob: （默认）全球。
• AreaCodeCN: 中国大陆。
• AreaCodeNA: 北美。
• AreaCodeEU: 欧洲。
• AreaCodeAS: 除中国大陆以外的亚洲区域。
• AreaCodeJP: 日本。
• AreaCodeIN: 印度。

区域码支持位操作。

示例代码

Go

svcCfg := agoraservice.NewAgoraServiceConfig()
svcCfg.AppId = appid

// 指定仅访问北美的服务器
svcCfg.AreaCode = agoraservice.AreaCodeNA

// 初始化 `agoraservice` 包
agoraservice.Initialize(svcCfg)