סקירה כללית על תמונת המצב של ה-API

אתם יכולים להשתמש ב-Snapshot API כדי לקבל מידע על הסביבה הנוכחית של המשתמש. באמצעות Snapshot API, אתם יכולים לגשת למגוון אותות הקשר:

  • פעילות משתמש שזוהתה, למשל כשהמשתמש הולך או נוהג.
  • משואות בקרבת מקום שרשמתם.
  • מצב האוזניות, מחוברות או לא.
  • מיקום, כולל קו רוחב וקו אורך.

המערכת שומרת את הערכים האלה במטמון כדי שתוכל להחזיר אותם במהירות. אם אין נתונים, המערכת מבצעת חישה והסקה כדי להחזיר ערכי מצב עדכניים. ‫Awareness API מחזיר את סוג הנתונים הקיים לסוגי הקשרים שיש להם API ציבורי.

לכל אות הקשר יש שיטת Snapshot API תואמת. לדוגמה, כדי לקבל את הפעילות שזוהתה, צריך להפעיל את getDetectedActivity(), להשתמש ב-SuccessListener כדי לקבל DetectedActivityResponse, ואז להפעיל את getActivityRecognitionResult() כדי להחזיר ActivityRecognitionResult שממנו אפשר לקבל את נתוני הבקשה בפועל.

בדוגמה הבאה אפשר לראות איך מקבלים את הפעילות האחרונה שזוהתה:

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

למידע נוסף על מה שאפשר לעשות עם נתוני הבקשה, ראו קבלת נתוני תמונת מצב.