يمكنك استخدام Snapshot API للحصول على معلومات حول بيئة المستخدم الحالية. باستخدام Snapshot API، يمكنك الوصول إلى مجموعة متنوعة من إشارات السياق:
- نشاط المستخدم الذي تم رصده، مثل المشي أو القيادة
- إشارات Bluetooth المجاورة التي سجّلتها
- حالة سماعة الرأس، سواء كانت متصلة أم لا
- الموقع الجغرافي، بما في ذلك خط العرض وخط الطول
يخزّن النظام هذه القيم مؤقتًا كي يتم عرضها بسرعة. في حال عدم توفّر بيانات، يتم إجراء الاستشعار والاستنتاج لعرض قيم الحالة الجديدة. تعرض واجهة برمجة التطبيقات Awareness 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();
}
})
لمزيد من المعلومات حول ما يمكنك فعله ببيانات الطلب، يُرجى الاطّلاع على الحصول على بيانات اللقطة.