В API Awareness концепция «зон» заимствована из концепции геозонирования , в которой определяется географическая область, или геозона , и приложение получает обратные вызовы, когда пользователь входит в эту область или покидает её. API Fence расширяет концепцию геозонирования, включая множество других контекстных условий в дополнение к географической близости. Приложение получает обратные вызовы всякий раз, когда происходит изменение контекстного состояния. Например, если ваше приложение определяет зону для наушников, оно получает обратные вызовы, когда наушники подключены и когда они отключены.
Вы можете использовать API Fence для определения границ (fence) на основе контекстных сигналов, например, следующих:
- Текущее местоположение пользователя (широта/долгота)
- Текущая активность пользователя, например, ходьба или вождение автомобиля.
- Условия, специфичные для устройства, например, подключены ли наушники.
- Близость к расположенным поблизости маякам
API Fence позволяет комбинировать несколько контекстных сигналов для создания ограждений с помощью логических операторов AND , OR и NOT . Затем ваше приложение получает обратные вызовы всякий раз, когда выполняются условия ограждения. Примеры возможных ограждений включают следующее:
- Пользователь вставляет наушники и начинает идти.
- Пользователь входит в 100-метровую геозону до 17:00 в будний день.
- Пользователь входит в зону действия конкретного 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);
}
}
}