文档中心
互动直播 (Legacy)
Console 官网 社区 技术支持
简体中文
search-icon

限定访问区域

更新时间 2023/01/11 09:35:20

功能描述

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

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

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

实现方法

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

你需要在调用 sharedEngineWithConfig 方法创建 AgoraRtcEngineKit 实例时，通过设置 AgoraRtcEngineConfig 中的 areaCode 参数来指定访问区域。

  • AgoraAreaCodeGLOB: （默认）全球。
  • AgoraAreaCodeCN: 中国大陆。
  • AgoraAreaCodeNA: 北美。
  • AgoraAreaCodeEU: 欧洲。
  • AgoraAreaCodeAS: 除中国大陆以外的亚洲区域。
  • AgoraAreaCodeJP: 日本。
  • AgoraAreaCodeIN: 印度。
  • 上述区域码适用于 RTC Native SDK v3.1.1 及之后版本。v3.1.1 之前版本的区域码可以参考各版本 API 文档。
  • 区域码支持位操作。

示例代码

// Swift
let agoraRtcEngineConfig = AgoraRtcEngineConfig();
agoraRtcEngineConfig.appId = type.appId(isClassical: settings.shouldUseClassicalAppIds)
// 指定仅访问北美的服务器。
agoraRtcEngineConfig.areaCode = AgoraAreaCode.NA.rawValue
agoraKit = AgoraRtcEngineKit.sharedEngine(with: agoraRtcEngineConfig, delegate: self)

开发注意事项

如果你的网络环境部署了防火墙，使用该功能还需要根据使用云代理添加防火墙白名单。