A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Límites de intent de pantalla completa
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Para prevenir el spam de anuncios y el phishing de credenciales, a partir de Android 14, el permiso predeterminado de USE_FULL_SCREEN_INTENT para enviar las notificaciones de pantalla completa podrá otorgarse solo a las apps que brinden funciones de llamadas y alarmas.
Para todas las apps que se instalan en Android 14, el permiso USE_FULL_SCREEN_INTENT está habilitado de forma predeterminada. Durante la instalación, Google Play Store revoca el permiso de intent de pantalla completa (FSI) para las apps que no tienen funciones de llamada o alarma.
En el caso de las apps instaladas en teléfonos con versiones de Android 13 o anteriores, el permiso USE_FULL_SCREEN_INTENT permanece habilitado de forma predeterminada.
Permiso del usuario
Con Android 14, las apps pueden usar NotificationManager#canUseFullScreenIntent() para verificar si pueden enviar notificaciones de pantalla completa. Para obtener el permiso del usuario para enviar notificaciones de pantalla completa, las apps usan ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT para iniciar la configuración Administrar intents de pantalla completa, como se muestra en la Figura 1:
Figura 1: IU para permitir que las apps envíen intents de pantalla completa.
La opción Administrar intents de pantalla completa se encuentra en el menú Configuración, en Acceso especial de apps. Con esta IU, los usuarios pueden revocar este permiso si es necesario.
Requisitos del OEM
En Android 14, los permisos de FSI para las apps están habilitados de forma predeterminada. Los OEMs deben especificar qué apps califican para los permisos de FSI. Los OEMs deben asegurarse de que las tiendas de aplicaciones de terceros establezcan los estados de otorgamiento iniciales de los permisos de FSI para sus apps con PackageInstaller.SessionParams, específicamente con los parámetros PERMISSION_STATE_DEFAULT, PERMISSION_STATE_DENIED y PERMISSION_STATE_GRANTED.
Validación
Usa la prueba del verificador de CTS en NotificationFullScreenIntentVerifierActivity.java y la prueba de CTS en NotificationManagerTest.java para validar los límites de FSI.
Pruebas manuales
Sigue estos pasos para probar manualmente los límites de FSI en tu app:
- Declara
USE_FULL_SCREEN_INTENT en el archivo AndroidManifest.xml de tu app.
- Usa
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT para administrar la configuración y activar o desactivar la FSI.
- En el teléfono de prueba, activa o desactiva manualmente el permiso del usuario para las notificaciones de pantalla completa, como se muestra en la Figura 1.
- Enviar una notificación de FSI
- Valida la apariencia de la notificación de pantalla completa para las siguientes combinaciones de permisos de FSI y modos de visualización:
|
Permiso de FSI
|
Pantalla desbloqueada
|
Pantalla bloqueada
|
Fuera de pantalla
|
Pantalla siempre activa (PSA)
|
| Otorgado por el usuario
|
Notificación emergente persistente (HUN) con botones de píldora
|
Cómo iniciar FSI
|
Cómo iniciar FSI
|
Cómo iniciar FSI
|
| Rechazado por el usuario
|
HUN con botones de píldora durante 60 segundos
|
HUN con botones de píldora aparece primero en la lista durante 60 segundos
|
Se activa la AOD y se muestra la HUN con botones de píldora durante 60 segundos.
|
HUN con botones de píldora durante 60 segundos
|
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],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 |"]]
