Fence API 總覽

在 Awareness API 中，「圍欄」的概念來自「地理圍欄」，也就是定義地理區域或「地理圍欄」，並在使用者進入或離開地理圍欄區域時，讓應用程式接收回呼。Fence API 擴充了地理圍欄的概念，除了地理位置鄰近程度外，還納入許多其他情境條件。只要情境狀態轉換，應用程式就會收到回呼。舉例來說，如果應用程式定義耳機的柵欄，當耳機插入和拔除時，應用程式就會收到回呼。

您可以使用 Fence API，根據情境信號定義柵欄，例如：

  • 使用者目前所在位置 (緯度/經度)
  • 使用者目前的活動，例如步行或開車。
  • 裝置專屬條件，例如是否已插入耳機。
  • 與附近 Beacon 的距離

Fence API 可讓您結合多個內容信號，並使用 AND、OR 和 NOT 布林運算子建立柵欄。應用程式會在符合圍欄條件時收到回呼。以下列舉幾種可能的圍欄：

  • 使用者接上耳機並開始走路。
  • 使用者在工作日下午 5 點前進入 100 公尺的地理圍欄。
  • 使用者進入特定 BLE 信標的範圍。

以下範例說明如何定義圍欄，在使用者步行時啟動：

AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);

定義圍欄後，您必須執行下列操作：

  • 呼叫 updateFences 註冊圍欄，接收回呼。
  • 定義可在圍欄狀態變更時叫用的回呼。

以下範例顯示建立及註冊柵欄的方法。在本範例中，系統會使用 BroadcastReceiver 的自訂子類別，在觸發圍欄時處理意圖。

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);
        }
    }
}