文档中心
互动直播
Agora.io 社区
中文
search-icon
限定访问区域
更新时间 2021/03/24 02:17:25

功能描述

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

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

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

实现方法

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

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

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

示例代码

IRtcEngine  *m_lpAgoraEngine = NULL;
RtcEngineContext ctx;

if(m_lpAgoraEngine == NULL)
    m_lpAgoraEngine = createAgoraRtcEngine();
ctx.eventHandler = &m_EngineEventHandler;
ctx.appId = appId;
if (hWnd != NULL)
    ctx.context = hWnd;
// 指定仅访问北美的服务器。
ctx.areaCode = rtc::AREA_CODE_NA;
m_lpAgoraEngine->initialize(ctx);

开发注意事项

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

score