限定访问区域

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

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

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

信息

该功能为 SDK 的高级设置功能，声网建议你仅在有访问安全限制的场景使用。

实现方法

声网 RTSA SDK 从 v1.5.0 起，支持限定区域访问。一旦指定了访问区域，音视频和消息数据将不会访问指定区域以外的服务器。

你需要在调用 agora_rtc_init 方法初始化 SDK 时，通过设置 option 参数中的 area_code 参数来指定访问区域。

• AREA_CODE_CN: 中国大陆
• AREA_CODE_NA: 北美
• AREA_CODE_EU: 欧洲
• AREA_CODE_AS: 亚洲（除中国大陆）
• AREA_CODE_JP: 日本
• AREA_CODE_IN: 印度
• AREA_CODE_OC: 大洋洲
• AREA_CODE_SA: 南美
• AREA_CODE_AF: 非洲
• AREA_CODE_KR: 韩国
• AREA_CODE_HKMC: 香港和澳门
• AREA_CODE_US: 美国
• AREA_CODE_RU: 俄罗斯
• AREA_CODE_OVS: 全球（除中国）
• AREA_CODE_GLOB: （默认）全球。

信息

区域码支持位操作。

示例代码

参考如下示例代码在你的 App 中实现限定访问区域功能。

C

// 设置区域为北美
rtc_service_option_t service_opt;
service_opt.area_code = AREA_CODE_NA;

...

// 初始化 SDK
rval = agora_rtc_init(appid, &event_handler, &service_opt);

API 参考

开发过程中，你还可以参考如下文档，了解各 API 的详细信息：

• agora_rtc_init