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