通知
RTM 1.x 将于近期下架，各版本退休日期和替代方案详见 退休政策 。
文档中心
云信令（原实时消息）
Console 官网 社区 技术支持
简体中文
search-icon

限定访问区域

更新时间 2021/04/08 11:54:59

功能描述

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

如果要设置印度为限定区域，你必须从印度的 IP 地址发起请求。否则会设置失败。

实现方法

你需要在调用 createClient 初始化 RTM 客户端之前调用 setRtmServiceContext 设置限定区域。RTM SDK 支持以下区域：

  • AREA_CODE_GLOB: （默认）全球。
  • AREA_CODE_CN: 中国大陆。
  • AREA_CODE_NA: 北美区域。
  • AREA_CODE_EU: 欧洲区域。
  • AREA_CODE_AS: 除中国大陆外的亚洲区域。
  • AREA_CODE_JP: 日本。
  • AREA_CODE_IN: 印度。

示例代码

// 设置限定区域
RtmServiceContext context = new RtmServiceContext();
context.areaCode = RtmServiceContext.RtmAreaCode.AREA_CODE_CN | RtmServiceContext.RtmAreaCode.AREA_CODE_NA;
RtmClient.setRtmServiceContext(context);

开发注意事项

防火墙要求

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

  • 域名白名单
区域 域名
中国大陆 ap.agoraio.cn
report-edge.agoraio.cn
service-agoraio.cn
北美区域 ap-america.agora.io
report-america.agora.io
service-america.agora.io
欧洲区域 ap-europe.agora.io
report-europe.agora.io
service-europe.agora.io
日本 ap-japan.agora.io
report-japan.agora.io
service-japan.agora.io
印度 ap-india.agora.io
report-india.agora.io
service-india.agora.io
除中国大陆外的亚洲区域 ap-asia.agora.io
report-asia.agora.io
service-asia.agora.io
区域码支持位操作。
  • 端口

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

API 参考

setRtmServiceContext