为适应不同国家或地区的法律法规,声网支持限定访问区域功能,实现 SDK 只访问指定区域内的声网服务器,将音视频和消息数据传输限定在某一区域范围内。
假设你指定北美为访问区域,SDK 只访问北美区域内的声网服务器。无法分配北美区域服务器时,SDK 会报错,而不是使用其他区域服务器替代。
声网 RTSA Pro SDK 从 v2.1.1 起,支持限定区域访问。一旦指定了访问区域,音视频和消息数据将不会访问指定区域以外的服务器。
你需要在调用 initialize
方法初始化 IAgoraService
实例时,通过设置 AgoraServiceConfiguration
中的 areaCode
参数来指定访问区域。
AREA_CODE_GLOB
: (默认)全球。AREA_CODE_CN
: 中国大陆。AREA_CODE_NA
: 北美。AREA_CODE_EU
: 欧洲。AREA_CODE_AS
: 除中国大陆以外的亚洲区域。AREA_CODE_JP
: 日本。AREA_CODE_IN
: 印度。// 创建 IAgoraService 实例
auto service = createAgoraService();
agora::base::AgoraServiceConfiguration scfg;
scfg.enableAudioProcessor = true;
scfg.enableAudioDevice = false;
scfg.enableVideo = true;
scfg.useStringUid = false;
// 指定仅访问北美的服务器
scfg.areaCode = agora::rtc::AREA_CODE_NA;
// 初始化 IAgoraService 实例
service->initialize(scfg);