Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Einschränkungen für Full-Screen Intents
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Zum Schutz vor Spam und Phishing kann ab Android 14 die standardmäßige USE_FULL_SCREEN_INTENT-Berechtigung zum Senden von Vollbildbenachrichtigungen nur für Apps gewährt werden, die Anruf- und Weckerfunktionen bieten.
Für alle Apps, die unter Android 14 installiert werden, ist die Berechtigung
USE_FULL_SCREEN_INTENT
standardmäßig aktiviert. Beim Installieren widerrufen wir im Google Play Store die Full-Screen-Intent-Berechtigung für Apps, die keine Anruf- oder Weckfunktionen haben.
Bei Apps, die auf Smartphones mit Android 13 oder niedriger installiert sind, bleibt die Berechtigung USE_FULL_SCREEN_INTENT standardmäßig aktiviert.
Nutzerberechtigung
Unter Android 14 können Apps mit NotificationManager#canUseFullScreenIntent() prüfen, ob sie Vollbildbenachrichtigungen senden können. Um die Nutzerberechtigung zum Senden von Vollbildbenachrichtigungen einzuholen, verwenden Apps ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT, um die Einstellung Full-Screen Intents verwalten aufzurufen, wie in Abbildung 1 dargestellt:
Abbildung 1: Benutzeroberfläche, mit der Apps Vollbild-Intents senden können
Die Einstellung Vollbild-Intents verwalten finden Sie im Menü Einstellungen unter Spezieller App-Zugriff. Über diese Benutzeroberfläche können Nutzer diese Berechtigung bei Bedarf widerrufen.
OEM-Anforderungen
Unter Android 14 sind FSI-Berechtigungen für Apps standardmäßig aktiviert. OEMs müssen angeben, welche Apps für FSI-Berechtigungen infrage kommen. OEMs müssen dafür sorgen, dass App-Shops von Drittanbietern die anfänglichen Berechtigungszustände für FSI-Berechtigungen für ihre Apps mithilfe von PackageInstaller.SessionParams festlegen, insbesondere mit den Parametern PERMISSION_STATE_DEFAULT, PERMISSION_STATE_DENIED und PERMISSION_STATE_GRANTED.
Zertifizierungsstufe
Verwenden Sie den CTS-Verifier-Test in NotificationFullScreenIntentVerifierActivity.java und den CTS-Test in NotificationManagerTest.java, um die FSI-Limits zu validieren.
Manuelle Tests
So testen Sie die Limits für nutzerdefinierte Suchbegriffe in Ihrer App manuell:
- Deklarieren Sie
USE_FULL_SCREEN_INTENT in der AndroidManifest.xml-Datei Ihrer App.
- Mit
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT können Sie die Einstellungen verwalten, um FSI zu aktivieren oder zu deaktivieren.
- Aktivieren oder deaktivieren Sie auf Ihrem Testsmartphone die Nutzerberechtigung für Vollbildbenachrichtigungen manuell, wie in Abbildung 1 dargestellt.
- Senden Sie eine FSI-Benachrichtigung.
- Prüfen Sie die Darstellung der Vollbildbenachrichtigung für die folgenden Kombinationen von FSI-Berechtigung und Anzeigemodus:
|
Berechtigung für Finanzdienstleistungsunternehmen
|
Entriegeltes Display
|
Gesperrter Bildschirm
|
Nicht sichtbar
|
Always-On-Display (AOD)
|
| Vom Nutzer gewährt
|
Dauerhafte wichtige Benachrichtigung (HUN) mit Tablettenschaltflächen
|
FSI starten
|
FSI starten
|
FSI starten
|
| Vom Nutzer abgelehnt
|
HUN mit Tablettenschaltflächen für 60 Sekunden
|
HUN mit Tablettenschaltflächen wird 60 Sekunden lang zuerst in der Liste angezeigt
|
AOD wird aktiviert und zeigt 60 Sekunden lang den Bildschirmschoner mit den Tablettenschaltflächen an.
|
HUN mit Tablettenschaltflächen für 60 Sekunden
|
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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 |"]]
