نمای کلی API Snapshot

شما می‌توانید از Snapshot API برای دریافت اطلاعات در مورد محیط فعلی کاربر استفاده کنید. با Snapshot API، می‌توانید به انواع سیگنال‌های زمینه‌ای دسترسی داشته باشید:

  • فعالیت کاربر شناسایی شده، مانند زمانی که راه می‌رود یا رانندگی می‌کند.
  • بیکن‌های نزدیکی که ثبت کرده‌اید.
  • وضعیت هدفون، وصل بودن یا نبودن آن.
  • موقعیت مکانی، که شامل طول و عرض جغرافیایی می‌شود.

سیستم این مقادیر را ذخیره می‌کند تا بتوان آنها را به سرعت بازگرداند. اگر داده‌ای وجود نداشته باشد، حسگری و استنتاج برای بازگرداندن مقادیر حالت جدید انجام می‌شود. API آگاهی، نوع داده موجود را برای انواع زمینه‌ای که دارای API عمومی هستند، برمی‌گرداند.

هر سیگنال زمینه یک متد API مربوط به Snapshot دارد. برای مثال، برای دریافت فعالیت شناسایی شده فعلی، getDetectedActivity() را فراخوانی می‌کنید، از یک SuccessListener برای دریافت DetectedActivityResponse استفاده می‌کنید، سپس getActivityRecognitionResult() را برای بازگرداندن ActivityRecognitionResult فراخوانی می‌کنید که از آن می‌توانید داده‌های درخواست واقعی را دریافت کنید.

مثال زیر نحوه دریافت آخرین فعالیت شناسایی شده را نشان می‌دهد:

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

برای اطلاعات بیشتر در مورد کارهایی که می‌توانید با داده‌های درخواست انجام دهید، به دریافت داده‌های Snapshot مراجعه کنید.