Awareness API에서 펜스 개념은 지리적 영역 또는 지오펜스가 정의된 지오펜싱에서 가져오며, 사용자가 지오펜싱 영역에 들어가거나 나올 때 앱에서 콜백을 수신합니다. 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);
}
}
}