Snapshot API 概览

弃用通知：地点和天气上下文信号

您可以使用 Snapshot API 获取有关用户当前环境的信息。借助 Snapshot API，您可以访问各种情境信号：

• 检测到用户活动，例如他们步行或驾车时。
• 您注册的附近信标。
• 耳机状态，是否已插上。
• 位置，包括纬度和经度。

系统会缓存这些值，以便快速返回。如果没有数据，则执行感应和推断以返回最新状态值。Awareness API 会返回具有公共 API 的上下文类型的现有数据类型。

每个上下文信号都有一个对应的 Snapshot API 方法。例如，如需获取当前检测到的 activity，请调用 getDetectedActivity()，使用 SuccessListener 获取 DetectedActivityResponse，然后调用 getActivityRecognitionResult() 以返回 ActivityRecognitionResult，您可以从中获取实际的请求数据。

以下示例展示了如何获取最新检测到的活动：

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

如需详细了解如何处理请求数据，请参阅获取快照数据。