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

لمزيد من المعلومات حول ما يمكنك فعله ببيانات الطلب، يُرجى الاطّلاع على الحصول على بيانات Snapshot.