محدودیت‌های هدف تمام‌صفحه

در Android نسخه ۱۴ و بالاتر، برای جلوگیری از هرزآگهی و رمزگیری اطلاعات اعتباری، اجازه پیش‌فرض USE_FULL_SCREEN_INTENT برای ارسال اعلان‌های تمام‌صفحه فقط به برنامه‌هایی اعطا می‌شود که عملکردهای هشدار و تماس را ارائه می‌دهند.

برای همه برنامه‌هایی که در Android 14 نصب می‌شوند، اجازه USE_FULL_SCREEN_INTENT به‌طور پیش‌فرض فعال است. پس‌از نصب، «فروشگاه Google Play» اجازه هدف تمام‌صفحه (FSI) را برای برنامه‌هایی که عملکردهای تماس یا زنگ هشدار ندارند لغو می‌کند.

برای برنامه‌های نصب‌شده در تلفن‌هایی که نسخه‌های Android 13 یا پایین‌تر را اجرا می‌کنند، اجازه USE_FULL_SCREEN_INTENT به‌طور پیش‌فرض فعال می‌ماند.

اجازه کاربر

با Android 14، برنامه‌ها می‌توانند از NotificationManager#canUseFullScreenIntent() استفاده کنند تا بررسی کنند که آیا می‌توانند اعلان‌های تمام‌صفحه ارسال کنند یا نه. برای دریافت اجازه کاربر برای ارسال اعلان‌های تمام‌صفحه، برنامه‌ها از ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT برای راه‌اندازی تنظیم مدیریت هدف‌های تمام‌صفحه استفاده می‌کنند، همان‌طور که در «شکل ۱» نشان داده شده است:

fsi-ui

شکل ۱. رابط کاربری برای فعال کردن برنامه‌ها برای ارسال هدف‌های تمام‌صفحه.

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

الزامات سازنده اصلی محصول

در Android 14، اجازه‌های «هدف تمام‌صفحه» برای برنامه‌ها به‌طور پیش‌فرض فعال است. تولیدکنندگان تجهیزات اصلی باید مشخص کنند کدام برنامه‌ها برای اجازه‌های FSI واجدشرایط هستند. «تولیدکنندگان تجهیزات اصلی» باید مطمئن شوند که فروشگاه‌های برنامه طرف سوم وضعیت‌های اعطای اولیه اجازه‌های FSI را برای برنامه‌هایشان بااستفاده از PackageInstaller.SessionParams تنظیم می‌کنند، به‌ویژه با پارامترهای PERMISSION_STATE_DEFAULT، PERMISSION_STATE_DENIED، و PERMISSION_STATE_GRANTED.

اعتبارسنجی

از آزمون «درستی‌سنج CTS» در NotificationFullScreenIntentVerifierActivity.java، و آزمون CTS در NotificationManagerTest.java برای اعتبارسنجی محدودیت‌های FSI استفاده کنید.

آزمایش‌های دستی

برای آزمایش دستی محدودیت‌های FSI در برنامه‌تان، این مراحل را دنبال کنید:

  1. USE_FULL_SCREEN_INTENT را در فایل AndroidManifest.xml برنامه‌تان اعلام کنید.
  2. از ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT برای مدیریت تنظیمات روشن یا خاموش کردن «شناسه فضای ابری» استفاده کنید.
  3. در تلفن آزمایشی، اجازه کاربر برای اعلان‌های تمام‌صفحه را به‌صورت دستی روشن/خاموش کنید، همان‌طور که در «شکل ۱» نشان داده شده است.
  4. اعلان FSI ارسال کنید.
  5. ظاهر اعلان تمام‌صفحه را برای ترکیب‌های زیر از اجازه FSI و حالت‌های نمایش اعتبارسنجی کنید:
اجازه FSI صفحه قفل‌باز صفحه قفل خاموش کردن صفحه‌نمایش نمایشگر همیشه روشن (AOD)
کاربر اعطا کرد اعلان هشدار دائمی (HUN) با دکمه‌های قرصی راه‌اندازی FSI راه‌اندازی FSI راه‌اندازی FSI
کاربر رد کرد اعلان هشدار با دکمه‌های کپسولی به‌مدت ۶۰ ثانیه اعلان هشدار با دکمه‌های قرصی‌شکل ابتدا در فهرست به‌مدت ۶۰ ثانیه نشان داده می‌شود «نمایشگر همیشه روشن» روشن می‌شود، HUN را با دکمه‌های قرصی به‌مدت ۶۰ ثانیه نشان می‌دهد اعلان هشدار با دکمه‌های قرصی‌شکل به‌مدت ۶۰ ثانیه