از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
محدودیت های هدف تمام صفحه
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای جلوگیری از هرزنامه تبلیغاتی و فیشینگ اعتبار، با شروع Android 14، مجوز پیش‌فرض 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 برای راه‌اندازی تنظیمات مدیریت اهداف تمام صفحه همانطور که در شکل 1 نشان داده شده است، استفاده می‌کنند:
شکل 1. UI برای فعال کردن برنامه ها برای ارسال اهداف تمام صفحه.
تنظیمات مدیریت اهداف تمام صفحه در منوی تنظیمات در زیر دسترسی به برنامه ویژه است. با این رابط کاربری، کاربران می توانند در صورت نیاز این مجوز را لغو کنند.
الزامات نصب شده
در اندروید 14، مجوزهای FSI برای برنامه ها به طور پیش فرض فعال هستند. OEM ها باید مشخص کنند که کدام برنامه ها واجد شرایط مجوز FSI هستند. OEM ها باید اطمینان حاصل کنند که فروشگاه های برنامه شخص ثالث، وضعیت های اعطای اولیه مجوزهای FSI را برای برنامه های خود با استفاده از PackageInstaller.SessionParams ، به ویژه با پارامترهای PERMISSION_STATE_DEFAULT ، PERMISSION_STATE_DENIED ، و PERMISSION_STATE_GRANTED تنظیم می کنند.
اعتبار سنجی
از تست CTS Verifier در NotificationFullScreenIntentVerifierActivity.java و تست CTS در NotificationManagerTest.java برای اعتبارسنجی محدودیت های FSI استفاده کنید.
تست های دستی
برای آزمایش دستی محدودیت های FSI در برنامه خود، این مراحل را دنبال کنید:
-
USE_FULL_SCREEN_INTENT در فایل AndroidManifest.xml برنامه خود اعلام کنید. - از
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT برای مدیریت تنظیمات روشن یا خاموش کردن FSI استفاده کنید. - در تلفن آزمایشی خود، همانطور که در شکل 1 نشان داده شده است، به صورت دستی مجوز کاربر را برای اعلان های تمام صفحه تغییر دهید.
- یک اعلان FSI ارسال کنید.
- ظاهر اعلان تمام صفحه را برای ترکیب‌های زیر از مجوز FSI و حالت‌های نمایش تأیید کنید:
| مجوز FSI | صفحه باز شده | صفحه قفل شده | صفحه خاموش | نمایشگر همیشه روشن (AOD) |
| اعطا شده توسط کاربر | اعلان سربالا (HUN) با دکمه های قرص | FSI را راه اندازی کنید | FSI را راه اندازی کنید | FSI را راه اندازی کنید |
| توسط کاربر رد شد | HUN با دکمه های قرص برای دهه 60 | HUN با دکمه‌های قرص اولین بار در لیست برای دهه 60 نشان داده می‌شود | AOD روشن می شود، HUN را با دکمه های قرص برای دهه 60 نشان می دهد | HUN با دکمه های قرص برای دهه 60 |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Full-screen intent limits\n\nTo prevent ad spam and credential phishing, starting with Android 14,\nthe default [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission to send full-screen notifications can be granted only to apps that\nprovide calling and alarm functionalities.\n\nFor all apps being installed on Android 14, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission is enabled by default. Upon installation, the Google Play Store\nrevokes the full-screen intent (FSI) permission for apps that do not have\ncalling or alarm functionalities.\n\nFor apps installed on phones running versions\nAndroid 13 or lower, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission remains enabled by default.\n\nUser permission\n---------------\n\nWith Android 14, apps can use [`NotificationManager#canUseFullScreenIntent()`](https://developer.android.com/reference/android/app/NotificationManager#canUseFullScreenIntent())\nto check if they can send full-screen notifications. To get user permission to\nsend full-screen notifications, apps use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT)\nto launch the **Manage full screen intents** setting as shown in Figure 1:\n\n**Figure 1.** UI for enabling apps to send full-screen intents.\n\nThe **Manage full screen intents** setting is in the **Settings** menu under\n**Special App Access**. With this UI, users can revoke this permission if needed.\n\nOEM requirements\n----------------\n\nIn Android 14, FSI permissions for apps are enabled by\ndefault. OEMs must specify which apps qualify for FSI permissions. OEMs must\nensure that third-party app stores set the initial grant states of FSI\npermissions for their apps using\n[`PackageInstaller.SessionParams`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams),\nspecifically with the [`PERMISSION_STATE_DEFAULT`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DEFAULT), [`PERMISSION_STATE_DENIED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DENIED), and [`PERMISSION_STATE_GRANTED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_GRANTED)\nparameters.\n\nValidation\n----------\n\nUse the CTS Verifier test in [`NotificationFullScreenIntentVerifierActivity.java`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/apps/CtsVerifier/src/com/android/cts/verifier/notifications/NotificationFullScreenIntentVerifierActivity.java),\nand the CTS test in [`NotificationManagerTest.java`](https://cs.android.com/android/platform/superproject/+/android-latest-release:cts/tests/app/src/android/app/cts/NotificationManagerTest.java;drc=ed156b1d4a7d91675dba1adb9191a92cf439dab0;l=148)\nto validate the FSI limits.\n\n### Manual tests\n\nFollow these steps to manually test FSI limits on your app:\n\n1. Declare [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT) in your app's `AndroidManifest.xml` file.\n2. Use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT) to manage settings to turn FSI on or off.\n3. On your test phone, manually toggle the user permission for full-screen notifications as shown in Figure 1.\n4. Send an FSI notification.\n5. Validate the appearance of the full-screen notification for the following combinations of FSI permission and display modes:\n\n|--------------------|----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------|-------------------------------|\n| **FSI permission** | **Unlocked screen** | **Locked screen** | **Off screen** | **Always-on display (AOD)** |\n| Granted by user | Persistent heads-up notification (HUN) with pill buttons | Launch FSI | Launch FSI | Launch FSI |\n| Denied by user | HUN with pill buttons for 60s | HUN with pill buttons shows up first in the list for 60s | AOD turns on, shows HUN with pill buttons for 60s | HUN with pill buttons for 60s |"]]
