在 Awareness API 中，Fences 的概念是從地理圍欄定義的地理區域，也就是地理位置或「地理圍欄」。當使用者進入或離開地理圍欄時，應用程式會收到回呼。Fence API 以地理圍欄的概念為基礎，除了地理位置附近，還加入許多其他結構定義條件。每當結構定義狀態轉換時，應用程式會收到回呼。舉例來說，如果應用程式定義了耳機的圍欄，則會在耳機接上時收到回呼。
您可以使用 Fence API 根據內容訊號定義圍欄，例如：
- 使用者目前的位置 (經緯度)
- 使用者目前的活動，例如步行或開車。
- 裝置專用條件，例如是否接上耳機。
- 與附近信標之間的距離
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);
}
}
}