محدودیت‌های مکان پس‌زمینه‌ای

برای کاهش مصرف برق، Android نسخه ۸.۰ (سطح میانای برنامه‌سازی کاربردی ۲۶) دفعاتی را که برنامه می‌تواند مکان فعلی کاربر را درحین اجرا در پس‌زمینه بازیابی کند محدود می‌کند. در این شرایط، برنامه‌ها فقط چند بار در ساعت می‌توانند به‌روزرسانی‌های مکان را دریافت کنند.

توجه: این محدودیت‌ها برای همه برنامه‌های مورداستفاده در دستگاه‌های دارای Android نسخه ۸.۰ (سطح میانای برنامه‌سازی کاربردی ۲۶) یا بالاتر، صرف‌نظر از نسخه کیت توسعه نرم‌افزار هدف برنامه، اعمال می‌شود.

اگر برنامه‌تان هنگام اجرا در پس‌زمینه به هشدارهای هم‌زمان یا تشخیص حرکت متکی است، به‌ویژه مهم است که این رفتار بازیابی مکان را به‌خاطر داشته باشید.

رفتار برنامه پیش‌زمینه حفظ می‌شود

اگر برنامه‌ای در پیش‌زمینه دستگاهی باشد که Android 8.0 (سطح ای‌پی‌آی ۲۶) را اجرا می‌کند، رفتار به‌روزرسانی مکان همانند Android 7.1.1 (سطح ای‌پی‌آی ۲۵) و پایین‌تر است.

هشدار: اگر برنامه‌تان به‌روزرسانی‌های مکان تقریباً هم‌زمان را در مدت زمان طولانی بازیابی کند، عمر باتری دستگاه به‌طور قابل‌توجهی کوتاه‌تر می‌شود.

تنظیم رفتار مکان برنامه شما

ببینید آیا موارد استفاده برنامه‌تان برای اجرا در پس‌زمینه درصورت دریافت به‌روزرسانی‌های مکان نامتناوب اصلاً موفق می‌شود یا نه. اگر این‌طور است، می‌توانید با انجام یکی از کارهای زیر، به‌روزرسانی‌های مکان را با دفعات بیشتری بازیابی کنید:

  • برنامه‌تان را به پیش‌زمینه بیاورید.
  • با فراخوانی startForegroundService()، سرویس پیش‌زمینه‌ای را در برنامه‌تان شروع کنید. وقتی چنین سرویس پیش‌زمینه‌ای فعال باشد، به‌صورت اعلان درحال انجام در بخش اعلان‌ها نشان داده می‌شود.

    احتیاط: اگر برنامه شما سرویس پیش‌زمینه‌ای را درحین اجرا در پس‌زمینه در دستگاهی با Android نسخه ۱۱ (سطح API‏ ۳۰) یا بالاتر راه‌اندازی کند، برنامه شما نمی‌تواند به اطلاعات مکان دسترسی پیدا کند، مگراینکه کاربر اجازه ACCESS_BACKGROUND_LOCATION را به برنامه شما اعطا کرده باشد. برای اطلاعات بیشتر، راهنمای مربوط به محدودیت‌های درحین استفاده را که با سرویس‌های پیش‌زمینه‌ای مرتبط هستند مشاهده کنید.

  • از عناصر Geofencing API، مثل GeofencingClient، که برای به‌حداقل رساندن مصرف نیرو بهینه‌سازی شده‌اند استفاده کنید.
  • از شنونده مکان منفعل استفاده کنید که ممکن است به‌روزرسانی‌های مکان را سریع‌تر دریافت کند اگر برنامه‌های پیش‌زمینه‌ای وجود داشته باشند که به‌روزرسانی‌های مکان را با نرخ سریع‌تری درخواست کنند.

توجه: اگر برنامه‌تان به دسترسی به سابقه مکان نیاز دارد که حاوی به‌روزرسانی‌های مکرر زمانی است، از نسخه دسته‌ای عناصر میانای برنامه‌سازی کاربردی «ارائه‌دهنده تلفیقی مکان» مثل میانای FusedLocationProviderApi استفاده کنید. وقتی برنامه‌تان در پس‌زمینه اجرا می‌شود، این میانای برنامه‌سازی کاربردی مکان کاربر را با تناوب بیشتری نسبت‌به میانای برنامه‌سازی کاربردی غیردسته‌ای دریافت می‌کند. بااین‌حال، به‌خاطر داشته باشید که برنامه‌تان همچنان به‌روزرسانی‌ها را به‌صورت دسته‌ای و فقط چند بار در ساعت دریافت می‌کند.

میاناهای برنامه‌سازی کاربردی تحت‌تأثیر قرارگرفته

تغییرات در رفتار بازیابی مکان در برنامه‌های پس‌زمینه بر میاناهای برنامه‌سازی کاربردی زیر تأثیر می‌گذارد:

ارائه‌دهنده تلفیقی مکان (FLP)
  • اگر برنامه‌تان در پس‌زمینه اجرا می‌شود، سرویس سیستم مکان فقط چند بار در ساعت مکان جدیدی برای برنامه‌تان محاسبه می‌کند. این موضوع حتی زمانی‌که برنامه‌تان درخواست به‌روزرسانی‌های مکررتر مکان را دارد صادق است.

    بااین‌حال، بااستفاده از نسخه دسته‌ای «ارائه‌دهنده تلفیقی مکان»، پس‌از اینکه برنامه‌تان به‌روزرسانی دسته‌ای را دریافت کرد، به سابقه مکان با تناوب زمانی بیشتری دسترسی خواهید داشت. این به‌روزرسانی نیز فقط چند بار در ساعت انجام می‌شود.

  • اگر برنامه‌تان در پیش‌زمینه اجرا می‌شود، درمقایسه با Android 7.1.1 (سطح API‏ ۲۵) هیچ تغییری در نرخ نمونه‌برداری مکان ایجاد نمی‌شود.
حصارکشی جغرافیایی
  • برنامه‌های پس‌زمینه می‌توانند رویدادهای انتقال حصار جغرافیایی را بیشتر از به‌روزرسانی‌های «ارائه‌دهنده تلفیقی مکان» دریافت کنند.
  • میانگین پاسخ‌دهی برای رویداد حصار جغرافیایی هر چند دقیقه یک‌بار است.
اندازه‌گیری‌های GNSS و پیام‌های ناوبری GNSS
  • وقتی برنامه‌تان در پس‌زمینه است، فراخوانی‌های برگشتی که برای دریافت خروجی از GnssMeasurement و GnssNavigationMessage ثبت شده‌اند، اجرا نمی‌شوند.
مدیر مکان
  • به‌روزرسانی‌های مکان فقط چند بار در ساعت برای برنامه‌های پس‌زمینه ارائه می‌شود.

    توجه: اگر برنامه‌تان در دستگاهی اجرا می‌شود که «خدمات Google Play» در آن نصب شده است، اکیداً توصیه می‌شود به‌جای آن از ارائه‌دهنده تلفیقی مکان (FLP) استفاده کنید.

مدیر Wi-Fi
روش startScan() فقط چند بار در ساعت اسکن کامل برنامه‌های پس‌زمینه را انجام می‌دهد. اگر برنامه پس‌زمینه‌ای دوباره این روش را بلافاصله پس‌از آن فراخوانی کند، کلاس WifiManager نتایج ذخیره‌شده در حافظه نهان را از اسکن قبلی ارائه می‌دهد.