يمكنك استخدام 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();
}
})
لمعرفة مزيد من المعلومات حول ما يمكنك فعله باستخدام بيانات الطلب، يمكنك الاطّلاع على الحصول على بيانات "لمحة".