Обзор API моментальных снимков

Вы можете использовать API Snapshot для получения информации о текущей среде пользователя. С помощью API Snapshot вы можете получить доступ к различным контекстным сигналам :

  • Выявлена ​​активность пользователей, например, когда они идут пешком или едут за рулем.
  • Ближайшие маяки, которые вы зарегистрировали.
  • Состояние наушников: подключены они или нет.
  • Местоположение, включающее широту и долготу.

Система кэширует эти значения, чтобы их можно было быстро вернуть. Если данных нет, выполняются операции сбора данных и вывода для получения актуальных значений состояния. API Awareness возвращает существующий тип данных для типов контекста, имеющих публичный API.

Для каждого контекстного сигнала существует соответствующий метод API Snapshot. Например, чтобы получить текущую обнаруженную активность, вы вызываете getDetectedActivity() , используете SuccessListener для получения DetectedActivityResponse , а затем вызываете getActivityRecognitionResult() чтобы получить ActivityRecognitionResult , из которого можно получить фактические данные запроса.

В следующем примере показано, как получить информацию о последней обнаруженной активности:

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

Для получения более подробной информации о том, что можно сделать с данными запроса, см. раздел «Получение данных снимка» .