地理围栏

---

功能简介

地理围栏指将音视频及信令数据传输限定在某一区域，用以满足地区数据隐私安全相关法规，即限定访问某一特定区域的音视频服务。例如，当指定的地理围栏区域为欧洲时，不区分 App 用户所在区域，SDK 实际访问的区域将为欧洲。

当前 SDK 支持配置地区如下：

前提条件

在使用地理围栏功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

实现流程

1 开通地理围栏权限

地理围栏能力在某些情况下需要进行收费，请联系 ZEGO 商务确认并开通地理围栏权限。

2 设置地理围栏

• 地理围栏信息：包括地理围栏类型和地理围栏区域列表。
• 地理围栏类型：包括联合（Include）和排除（Exclude）两种类型，地理围栏类型将作用于地理围栏区域列表。
  • 联合：表示区域列表内的所有区域都包含在地理围栏内。
  • 排除：表示区域列表内容所有区域都排除在地理围栏外。

在创建 SDK 之前，调用 setGeoFence 接口，设置地理围栏信息。

// 设置联合模式的示例
const geofence_type = zgDefines.ZegoGeoFenceType.Include;//设置联合模式
// 设置区域列表信息，最少设置 1 个，最多设置不得大于 SDK 所支持个数
let geofence_area_list= [2, 3]  // 2-ZegoGeoFenceAreaCode.CN  3-ZegoGeoFenceAreaCode.NA
zgEngine.setGeoFence(geofence_type, geofence_area_list)  //在 createEngine 之前调用

// 设置排除模式的示例
const geofence_type = zgDefines.ZegoGeoFenceType.Exclude;//设置排除模式
// 设置区域列表信息，最少设置 1 个，最多设置不得大于 SDK 所支持个数
let geofence_area_list= [2, 3]  //2-ZegoGeoFenceAreaCode.CN  3-ZegoGeoFenceAreaCode.NA
zgEngine.setGeoFence(geofence_type, geofence_area_list)  //在 createEngine 之前调用

3 其他功能接入

完成地理围栏设置后，即可进行其他功能接入。