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