Обзор API забора

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В Awareness API концепция ограждений заимствована из геозоны , в которой определяется географический регион или геозона , и приложение получает обратные вызовы, когда пользователь входит или выходит из области геозоны. Fence API расширяет концепцию геозоны, включая многие другие условия контекста в дополнение к географической близости. Приложение получает обратные вызовы при каждом изменении состояния контекста. Например, если ваше приложение определяет забор для наушников, оно получает обратные вызовы, когда наушники подключены и когда они отключены.

Вы можете использовать Fence API для определения границ на основе сигналов контекста, таких как следующие:

  • Текущее местоположение пользователя (широта/долгота)
  • Текущая деятельность пользователя, например ходьба или вождение.
  • Условия, зависящие от устройства, например, подключены ли наушники.
  • Близость к ближайшим маякам

Fence API позволяет комбинировать несколько контекстных сигналов для создания ограждений с логическими операторами 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);
        }
    }
}