Tổng quan về API Tổng quan

Bạn có thể sử dụng Snapshot API để lấy thông tin về môi trường hiện tại của người dùng. Với Snapshot API, bạn có thể truy cập vào nhiều tín hiệu ngữ cảnh:

  • Hoạt động được phát hiện của người dùng, chẳng hạn như khi họ đi bộ hoặc lái xe.
  • Các beacon ở gần mà bạn đã đăng ký.
  • Trạng thái tai nghe, có cắm hay không.
  • Vị trí, bao gồm vĩ độ và kinh độ.

Hệ thống sẽ lưu vào bộ nhớ đệm các giá trị này để có thể trả về nhanh chóng. Nếu không có dữ liệu, quá trình cảm biến và suy luận sẽ được thực hiện để trả về các giá trị trạng thái mới. Awareness API trả về kiểu dữ liệu hiện có cho các kiểu ngữ cảnh có API công khai.

Mỗi tín hiệu bối cảnh có một phương thức Snapshot API tương ứng. Ví dụ: để lấy hoạt động được phát hiện hiện tại, bạn gọi getDetectedActivity(), sử dụng SuccessListener để lấy DetectedActivityResponse, sau đó gọi getActivityRecognitionResult() để trả về ActivityRecognitionResult mà từ đó bạn có thể lấy dữ liệu yêu cầu thực tế.

Ví dụ sau đây cho thấy cách lấy hoạt động được phát hiện mới nhất:

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

Để biết thêm thông tin về những việc bạn có thể làm với dữ liệu yêu cầu, hãy xem bài viết Lấy dữ liệu bản tổng quan nhanh.