نظرة عامة على 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();
                }
            })

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