在 Awareness API 中，围栏的概念源自地理围栏，其中定义了地理区域（即地理围栏），当用户进入或离开地理围栏区域时，应用会收到回调。Fence API 扩展了地理围栏的概念，除了地理位置相近之外，还包含许多其他情境条件。每当上下文状态发生转换时，应用都会收到回调。例如，如果您的应用为耳机定义了围栏，则会在耳机插入和拔出时收到回调。
您可以使用 Fence API 根据情境信号定义边界，例如：
- 用户的当前位置（纬度/经度）
- 用户当前的活动，例如步行或驾车。
- 设备专用条件，例如耳机是否已插入。
- 与附近信标的距离
借助 Fence API，您可以组合多个情境信号，使用 AND、OR 和 NOT 布尔运算符创建屏障。然后，每当满足栅栏条件时，您的应用都会收到回调。可能的围栏示例如下：
- 用户插入耳机并开始步行。
- 用户在工作日下午 5 点之前进入 100 米的地理围栏。
- 用户进入特定 BLE 信标的范围。
以下示例展示了如何定义一个每当用户步行时都会激活的围栏：
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
定义栅栏后，您必须执行以下操作：
- 调用
updateFences以注册栅栏以接收回调。 - 定义一个可在栅栏状态发生变化时调用的回调。
以下示例展示了用于创建和注册栅栏的方法。在此示例中，系统使用 BroadcastReceiver 的自定义子类来处理触发栅栏时的 intent。
Awareness.getFenceClient(this).updateFences(new FenceUpdateRequest.Builder()
.addFence(FENCE_KEY, exercisingWithHeadphonesFence, mPendingIntent)
.build())
.addOnSuccessListener(new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
Log.i(TAG, "Fence was successfully registered.");
}
})
.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(@NonNull Exception e) {
Log.e(TAG, "Fence could not be registered: " + e);
}
});
public class FenceReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
FenceState fenceState = FenceState.extract(intent);
if (TextUtils.equals(fenceState.getFenceKey(), FENCE_KEY)) {
String fenceStateStr;
switch (fenceState.getCurrentState()) {
case FenceState.TRUE:
fenceStateStr = "true";
break;
case FenceState.FALSE:
fenceStateStr = "false";
break;
case FenceState.UNKNOWN:
fenceStateStr = "unknown";
break;
default:
fenceStateStr = "unknown value";
}
mLogFragment.getLogView().println("Fence state: " + fenceStateStr);
}
}
}