نظرة عامة على Snapshot API

يمكنك استخدام Snapshot API للحصول على معلومات عن بيئة المستخدم الحالية. باستخدام Snapshot API، يمكنك الوصول إلى مجموعة متنوعة من إشارات السياق:

  • نشاط المستخدِم الذي تم رصده، مثل المشي أو القيادة
  • أجهزة الإرسال والاستقبال المجاورة التي سجّلتها
  • حالة سماعات الرأس، سواء كانت متصلة أم لا
  • الموقع الجغرافي، الذي يتضمّن خط العرض وخط الطول

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

لمزيد من المعلومات حول الإجراءات التي يمكنك اتّخاذها في ما يتعلّق ببيانات الطلب، اطّلِع على الحصول على بيانات المخطّط.