Snapshot API 개요

스냅샷 API를 사용하여 사용자의 현재 환경에 관한 정보를 가져올 수 있습니다. 스냅샷 API를 사용하면 다음과 같은 다양한 컨텍스트 신호에 액세스할 수 있습니다.

  • 사용자가 걷거나 운전하는 등의 감지된 사용자 활동입니다.
  • 등록한 근처 비콘
  • 헤드폰 상태(연결 여부)
  • 위도와 경도가 포함된 위치입니다.

시스템은 이러한 값을 빠르게 반환할 수 있도록 캐시합니다. 데이터가 없으면 감지 및 추론이 실행되어 최신 상태 값이 반환됩니다. Awareness API는 공개 API가 있는 컨텍스트 유형의 기존 데이터 유형을 반환합니다.

각 컨텍스트 신호에는 해당하는 스냅샷 API 메서드가 있습니다. 예를 들어 현재 감지된 활동을 가져오려면 getDetectedActivity()를 호출하고, SuccessListener를 사용하여 DetectedActivityResponse를 가져온 다음, getActivityRecognitionResult()를 호출하여 실제 요청 데이터를 가져올 수 있는 ActivityRecognitionResult를 반환합니다.

다음 예에서는 가장 최근에 감지된 활동을 가져오는 방법을 보여줍니다.

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

요청 데이터로 할 수 있는 작업에 관한 자세한 내용은 스냅샷 데이터 가져오기를 참고하세요.