Fence API 概览

在 Awareness API 中,栅栏的概念取自地理围栏,在此地理区域中定义了一个地理区域或地理围栏,当用户进入或离开地理围栏区域时,应用会收到回调。Fence API 对地理围栏这一概念进行了扩展,除了地理邻近度之外,还包含许多其他上下文条件。每当上下文状态转换时,应用都会收到回调。例如,如果您的应用为耳机定义了一个栅栏,则耳机在插入和拔下时都会收到回调。

您可以使用 Fence API 根据上下文信号定义栅栏,例如:

  • 用户的当前位置(纬度/经度)
  • 用户当前的活动,例如步行或驾车。
  • 设备专属条件,例如是否插入了耳机。
  • 靠近信标

通过 Fence API,您可以组合多个上下文信号来创建具有 ANDORNOT 布尔运算符的栅栏。这样,在满足栅栏条件后,您的应用就会收到回调。以下是可能的栅栏的一些示例:

  • 用户插入耳机并开始走路。
  • 用户在工作日下午 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);
        }
    }
}