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 Ảnh chụp nhanh, bạn có thể truy cập nhiều loại tín hiệu ngữ cảnh:

  • Phát hiện thấy hoạt động của người dùng, chẳng hạn như khi họ đi bộ hoặc lái xe.
  • Báo hiệu lân cận mà bạn đã đăng ký.
  • Trạng thái 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 trong bộ nhớ cache để có thể trả về chúng nhanh chóng. Nếu không có dữ liệu, thì cảm biến và suy luận sẽ được thực hiện để trả về 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 có một phương thức API Ảnh chụp nhanh tương ứng. Ví dụ: để nhận hoạt động hiện tại đã phát hiện, bạn gọi getDetectedActivity(), sử dụng SuccessListener để nhận DetectedActivityResponse, sau đó gọi getActivityRecognitionResult() để trả về ActivityRecognitionResult từ đó bạn có thể lấy dữ liệu yêu cầu thực tế.

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

        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.