限定访问区域

功能描述

为适应不同国家或地区的法律法规，Agora RTM SDK 支持限定访问区域功能。你可以将 Agora RTM SDK 的数据传输限定在某一区域范围内。限定区域之后，RTM SDK 只能连接位于限定区域的 Agora RTM 服务器。

实现方法

• 1.4.3 及以上版本

  你需要调用 AgoraRTM.setArea 方法来指定访问区域。默认情况下，SDK 会就近选择 Agora 服务器进行连接。设置访问区域之后，SDK 只会连接到指定区域内的 Agora 服务器。支持指定多个访问区域。区域可设为：

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

你可以设置 AgoraRTM.setArea 方法中的 excludeArea 参数去除访问区域中的个别区域，仅包括以下情况：

示例代码

 // 设置限定区域
 AgoraRTM.setArea({ areaCodes: ["GLOBAL"], excludedArea: "CHINA" })

• 1.4.3 以下版本
  你需要在调用 createInstance 初始化 RTM 客户端时通过 areaCodes 参数设置限定区域。RTM SDK 支持以下区域：

  • GLOB: （默认）全球。
  • CN: 中国大陆。
  • NA: 北美区域。
  • EU: 欧洲区域。
  • AS: 除中国大陆外的亚洲区域。
  • JP: 日本。
  • IN: 印度。

  示例代码

  // 设置限定区域
  AgoraRTM.createInstance('<appid>', {}, ["CN","GLOB"])；

开发注意事项

防火墙要求

如果你的网络环境部署了防火墙，你需要根据你指定的区域将下表中对应的域名添加到防火墙白名单，不对 IP 地址设限，且开放相应端口。

域名白名单

• 1.4.3 及以上版本

  区域	域名
  中国大陆	webrtc2-4.ap.sd-rtn.com webrtc2-2.ap.sd-rtn.com web-3.statscollector.sd-rtn.com web-4.statscollector.sd-rtn.com logservice-china.agora.io
  北美区域	ap-web-1-north-america.agora.io ap-web-2-north-america.agora.io statscollector-1-north-america.agora.io statscollector-2-north-america.agora.io logservice-north-america.agora.io
  欧洲区域	ap-web-1-europe.agora.io ap-web-2-europe.agora.io statscollector-1-europe.agora.io statscollector-2-europe.agora.io logservice-europe.agora.io
  日本	ap-web-1-japan.agora.io ap-web-2-japan.agora.io statscollector-1-japan.agora.io statscollector-2-japan.agora.io logservice-japan.agora.io
  印度	ap-web-1-india.agora.io ap-web-2-india.agora.io statscollector-1-india.agora.io statscollector-2-india.agora.io logservice-india.agora.io
  除中国大陆外的亚洲区域	ap-web-1-asia.agora.io ap-web-2-asia.agora.io statscollector-1-asia.agora.io statscollector-2-asia.agora.io logservice-asia.agora.io

• 1.4.3 以下版本

  区域	域名
  中国大陆	webrtc2-ap-web-2.agoraio.cn webrtc2-ap-web-4.agoraio.cn statscollector-3.agoraio.cn statscollector-4.agoraio.cn logservice-china.agora.io
  北美区域	ap-web-1-north-america.agora.io ap-web-2-north-america.agora.io statscollector-1-north-america.agora.io statscollector-2-north-america.agora.io logservice-north-america.agora.io
  欧洲区域	ap-web-1-europe.agora.io ap-web-2-europe.agora.io statscollector-1-europe.agora.io statscollector-2-europe.agora.io logservice-europe.agora.io
  日本	ap-web-1-japan.agora.io ap-web-2-japan.agora.io statscollector-1-japan.agora.io statscollector-2-japan.agora.io logservice-japan.agora.io
  印度	ap-web-1-india.agora.io ap-web-2-india.agora.io statscollector-1-india.agora.io statscollector-2-india.agora.io logservice-india.agora.io
  除中国大陆外的亚洲区域	ap-web-1-asia.agora.io ap-web-2-asia.agora.io statscollector-1-asia.agora.io statscollector-2-asia.agora.io logservice-asia.agora.io

• 端口

详见应用企业防火墙限制。

API 参考

createInstance
setArea