Snapshot API を使用すると、ユーザーの現在の環境に関する情報を取得できます。Snapshot API を使用すると、 さまざまな コンテキスト シグナルにアクセスできます。
- 歩行や運転など、検出されたユーザー アクティビティ。
- 登録済みの付近のビーコン。
- ヘッドフォンの状態（接続されているかどうか）。
- 位置情報（緯度と経度を含む）。
これらの値はシステムによってキャッシュされ、迅速に返されるようになっています。データがない場合は、センシングと推論が行われ、最新の状態の値が返されます。 Awareness API は、公開 API を持つコンテキスト タイプに対して既存のデータ型を返します。
各コンテキスト シグナルには、対応する Snapshot API メソッドがあります。たとえば、現在検出されているアクティビティを取得するには、
getDetectedActivity() を呼び出し、
SuccessListener を使用して DetectedActivityResponse を取得してから、
getActivityRecognitionResult()
を呼び出して ActivityRecognitionResult
を返します。この ActivityRecognitionResult から実際のリクエストデータを取得できます。
次の例は、最新の検出されたアクティビティを取得する方法を示しています。
Awareness.getSnapshotClient(this).getDetectedActivity()
.addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
@Override
public void onSuccess(DetectedActivityResponse dar) {
ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
}
})
リクエストデータでできることについて詳しくは、 スナップショット データを取得するをご覧ください。