为适应不同国家或地区的法律法规,声网支持限定访问区域功能。开启限定访问区域功能后,不论用户在哪个区域使用你的 app,SDK 都只会访问指定区域的声网服务器。
例如你指定了北美为访问区域,假设有两位用户分别从北美和中国连接声网服务器:
指定的访问区域 | App 用户所在区域 | SDK 实际访问的区域 | 连接后的用户体验 1 |
---|---|---|---|
北美 | 北美 | 北美 | 正常 |
中国 | 可能受到较大影响 2 |
你需要调用 AgoraRTM.setArea
方法来指定访问区域。默认情况下,SDK 会就近选择声网服务器进行连接。设置访问区域之后,SDK 只会连接到指定区域内的声网服务器。支持指定多个访问区域。区域可设为:
GLOBAL
: (默认)全球。CHINA
: 中国大陆。ASIA
: 除中国大陆以外的亚洲区域。EUROPE
: 欧洲区域。INDIA
: 印度。JAPAN
: 日本。NORTH_AMERICA
: 北美区域。你可以设置 AgoraRTM.setArea
方法中的 excludeArea
参数去除访问区域中的个别区域,仅包括以下情况:
访问区域 | 去除区域 | 描述 |
---|---|---|
GLOBAL |
CHINA |
海外区域 |
GLOBAL |
JAPAN |
除去日本的全球区域 |
GLOBAL |
ASIA |
除去亚洲的全球区域(包括中国大陆) |
GLOBAL
的限定区域,设置 exludedArea
无效。 示例代码
// 设置限定区域
AgoraRTM.setArea({ areaCodes: ["GLOBAL"], excludedArea: "CHINA" })
你需要在调用 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 |
端口
详见应用企业防火墙限制。