می‌توانید از API عکس فوری برای دریافت اطلاعات درباره محیط فعلی کاربر استفاده کنید. با «میانای برنامه‌سازی کاربردی Snapshot»، می‌توانید به انواع مختلفی از سیگنال‌های زمینه‌ای دسترسی داشته باشید:
- فعالیت کاربر تشخیص داده‌شده، مثلاً زمانی که پیاده‌روی یا رانندگی می‌کند.
- فرستنده‌های بلوتوثی اطراف که ثبت کرده‌اید.
- وضعیت هدفون، متصل بودن یا نبودن.
- مکان، که شامل طول و عرض جغرافیایی می‌شود.
سیستم این مقادیر را در حافظه نهان ذخیره می‌کند تا بتواند آن‌ها را به‌سرعت برگرداند. اگر داده‌ای وجود نداشته باشد، حس کردن و استنتاج برای برگرداندن مقادیر وضعیت جدید انجام می‌شود. «میانای برنامه‌سازی کاربردی آگاهی» نوع داده موجود را برای انواع زمینه‌ای که میانای برنامه‌سازی کاربردی عمومی دارند برمی‌گرداند.
هر سیگنال زمینه‌ای روش 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();
}
})
برای کسب اطلاعات بیشتر درباره کارهایی که می‌توانید با داده‌های درخواست انجام دهید، دریافت داده‌های «نمای کلی» را ببینید.