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 API Snapshot, bạn có thể truy cập vào nhiều tín hiệu ngữ cảnh:

  • Phát hiện hoạt động của người dùng, chẳng hạn như khi họ đi bộ hoặc lái xe.
  • Các beacon 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 sẽ 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, hệ thống sẽ thực hiện cảm biến và suy luận để trả về các giá trị trạng thái mới. API nhận biết trả về loại dữ liệu hiện có cho các loại ngữ cảnh có API công khai.

Mỗi tín hiệu ngữ cảnh đều có một phương thức API tổng quan tương ứng. Ví dụ: để nhận hoạt động đã 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, từ đó bạn có thể nhận 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.