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();
                }
            })

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