註冊圍欄

只要柵欄狀態變更，應用程式就會透過 PendingIntent 收到回呼。應用程式必須先註冊每個邊界，才能使用。

註冊邊界

如要註冊邊界，請使用 FenceClient，如要建構 FenceUpdateRequest，請使用 FenceClient.updateFences()。針對要新增的每個圍欄呼叫 addFence()。

註冊及取消註冊圍欄時，必須提供下列項目：

• Google Play Services API Client 例項。
• AwarenessFence 例項，即邊界本身。
• 用於處理狀態變更的 PendingIntent。
• 邊界鍵，這是用於識別邊界並對應至 AwarenessFence-PendingIntent 組合的字串。

以下程式碼範例顯示呼叫 updateFences() 以註冊邊界的方法：

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

如要建立多個含有專屬圍欄鍵的圍欄，請多次呼叫 addFence()。您可以視需要使用任多個 PendingIntent 方法，但建議您為所有圍欄回呼使用單一 PendingIntent。如果您使用已註冊用於呼叫 addFence() 的圍欄鍵，系統會覆寫該鍵的 AwarenessFence 和 PendingIntent 值。

取消註冊邊界

如要取消註冊邊界，請呼叫 getFenceClient().updateFences()，並使用 FenceUpdateRequest.Builder() 建構邊界更新要求。然後呼叫 removeFence()，如以下範例所示：

 Awareness.getFenceClient(this).updateFences(new FenceUpdateRequest.Builder()
     .removeFence(FENCE_KEY)
     .build())
     .addOnSuccessListener(new OnSuccessListener<Void>() {
         @Override
         public void onSuccess(Void aVoid) {
             Log.i(TAG, "Fence was successfully unregistered.");
         }
     })
     .addOnFailureListener(new OnFailureListener() {
         @Override
         public void onFailure(@NonNull Exception e) {
             Log.e(TAG, "Fence could not be unregistered: " + e);
         }
     });

注意： 您可以在同一個 FenceUpdateRequest 中新增及移除柵欄。新增和移除作業會按照要求中呼叫 addFence() 和 removeFence() 的順序執行。

後續步驟：管理邊界回呼。