Tổng quan về API Tổng quan

Bạn có thể dùng Snapshot API để nhận 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ủa người dùng được phát hiện, chẳng hạn như khi họ đi bộ hoặc lái xe.
  • Các thiết bị báo hiệu lân cận mà bạn đã đăng ký.
  • Trạng thái của tai nghe, đã cắm hay chưa.
  • Vị trí, bao gồm vĩ độ và kinh độ.

Hệ thống lưu các giá trị này vào bộ nhớ đệm để 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 bối cảnh có API công khai.

Mỗi tín hiệu bối cảnh đều có một phương thức Snapshot API tương ứng. Ví dụ: để nhận hoạt động được phát hiện hiện tại, bạn gọi getDetectedActivity(), sử dụng SuccessListener để nhận DetectedActivityResponse, sau đó gọi getActivityRecognitionResult() để trả về ActivityRecognitionResult mà từ đó bạn có thể nhận được 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 gần đây 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 phần Nhận dữ liệu Tổng quan nhanh.