उपयोगकर्ता के मौजूदा एनवायरमेंट के बारे में जानकारी पाने के लिए, Snapshot API का इस्तेमाल किया जा सकता है. Snapshot API की मदद से, कई तरह के कॉन्टेक्स्ट सिग्नल ऐक्सेस किए जा सकते हैं:
- उपयोगकर्ता गतिविधि का पता लगाया जाता है. जैसे, पैदल चलना या गाड़ी चलाना.
- आपके आस-पास मौजूद वे बीकन जिन्हें आपने रजिस्टर किया है.
- हेडफ़ोन की स्थिति, प्लग इन है या नहीं.
- जगह की जानकारी, जिसमें अक्षांश और देशांतर शामिल है.
सिस्टम इन वैल्यू को कैश मेमोरी में सेव करता है, ताकि इन्हें तुरंत दिखाया जा सके. अगर कोई डेटा मौजूद नहीं है, तो नई वैल्यू पाने के लिए सेंसिंग और अनुमान लगाने की प्रोसेस की जाती है. Awareness API, उन कॉन्टेक्स्ट टाइप के लिए मौजूदा डेटा टाइप दिखाता है जिनके लिए सार्वजनिक एपीआई उपलब्ध है.
हर कॉन्टेक्स्ट सिग्नल के लिए, स्नैपशॉट एपीआई का तरीका उपलब्ध है. उदाहरण के लिए, मौजूदा समय में की जा रही गतिविधि का पता लगाने के लिए, getDetectedActivity() को कॉल करें. इसके बाद, DetectedActivityResponse पाने के लिए SuccessListener का इस्तेमाल करें. इसके बाद, ActivityRecognitionResult को वापस पाने के लिए getActivityRecognitionResult() को कॉल करें. इससे आपको अनुरोध का असल डेटा मिल सकता है.
यहां दिए गए उदाहरण में, हाल ही में पता लगाई गई गतिविधि की जानकारी पाने का तरीका बताया गया है:
Awareness.getSnapshotClient(this).getDetectedActivity()
.addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
@Override
public void onSuccess(DetectedActivityResponse dar) {
ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
}
})
अनुरोध के डेटा का इस्तेमाल करके क्या-क्या किया जा सकता है, इस बारे में ज़्यादा जानने के लिए, स्नैपशॉट डेटा पाना लेख पढ़ें.