Создать забор

Забор определяет одно или несколько контекстных условий, на которые может реагировать ваше приложение. Когда состояние забора изменяется, ваше приложение получает обратный вызов.

Существует два типа ограждений: примитивные ограждения, которые представляют базовый набор контекстных сигналов, и комбинированные ограждения, которые объединяют несколько примитивных ограждений с использованием логических операторов. Все заборы являются экземплярами AwarenessFence .

Создать примитивный забор

Примитивные ограждения, которые представляют собой базовый набор контекстных сигналов, определены в пакете awareness.fence . В следующем примере показано создание простого забора, который имеет TRUE , когда обнаруженная активность пользователя — WALKING , и FALSE в противном случае:

AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);

В предыдущем примере DetectedActivityFence был создан вызовом во during , что означает, что забор находится в состоянии TRUE , когда пользователь WALKING .

Реагировать на переходы

Каждый примитивный тип ограждения, за исключением TimeFence , также может мгновенно запускаться при переходе состояния контекста. Например, вы можете настроить DetectedActivityFence на мгновенный запуск, когда пользователь starting или stopping действие. Ограничители перехода находятся в состоянии TRUE в течение нескольких секунд, прежде чем снова станут FALSE .

Сделать комбинированный забор

Комбинированные ограждения объединяют несколько примитивных типов ограждений с использованием логических операторов. В следующем примере показано создание комбинированного забора, который активируется, когда пользователь идет и наушники подключены:

// Create the primitive fences.
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
AwarenessFence headphoneFence = HeadphoneFence.during(HeadphoneState.PLUGGED_IN);

// Create a combination fence to AND primitive fences.
AwarenessFence walkingWithHeadphones = AwarenessFence.and(
      walkingFence, headphoneFence
);

Вложенные деревья AND , OR и NOT допустимы, поэтому возможна любая логическая комбинация ограждений. В следующем примере показано ограждение, которое срабатывает, когда пользователь перемещается более чем на 100 метров от текущего местоположения или когда с текущего момента времени прошло более часа.

double currentLocationLat;  // current location latitude
double currentLocationLng;  // current location longitude
long nowMillis = System.currentTimeMillis();
long oneHourMillis = 1L * 60L * 60L * 1000L;

AwarenessFence orExample = AwarenessFence.or(
        AwarenessFence.not(LocationFence.in(
                currentLocationLat,
                currentLocationLng,
                100.0,
                100.0,
                0L)),
        TimeFence.inInterval(nowMillis + oneHourMillis, Long.MAX_VALUE));

Следующий шаг: Зарегистрируйте забор .