Eine Benachrichtigung ist eine Nachricht, die Android außerhalb der Benutzeroberfläche Ihrer App anzeigt, dem Nutzer Erinnerungen, Mitteilungen von anderen Personen oder andere aktuelle Informationen aus Ihrer App. Nutzer können auf die Benachrichtigung tippen, um Ihr oder führen Sie direkt über die Benachrichtigung eine Aktion aus.
Auf dieser Seite erhalten Sie einen Überblick darüber, wo Benachrichtigungen angezeigt werden und welche Funktionen. Um mit dem Erstellen von Benachrichtigungen zu beginnen, lesen Sie Einen Benachrichtigung.
Weitere Informationen zum Benachrichtigungsdesign und zu Interaktionsmustern findest du in der Benachrichtigungsdesign .
Darstellung auf einem Gerät
Benachrichtigungen werden Nutzern an verschiedenen Standorten und in unterschiedlichen Formaten automatisch angezeigt. Eine Benachrichtigung wird als Symbol in der Statusleiste angezeigt. die Benachrichtigungsleiste und ein Logo auf dem App-Symbol. Auch Benachrichtigungen die auf gekoppelten Wearables erscheinen.
Status- und Benachrichtigungsleiste
Wenn Sie eine Benachrichtigung senden, wird sie zuerst als Symbol in der Statusleiste angezeigt.
Abbildung 1: Benachrichtigungssymbole werden links neben dem Status angezeigt. .
Nutzer können auf der Statusleiste nach unten wischen, um die Benachrichtigungsleiste zu öffnen. können sie weitere Details sehen und Aktionen für die Benachrichtigung ausführen.
Abbildung 2. Benachrichtigungen auf der Benachrichtigungsleiste.
Nutzer können eine Benachrichtigung auf der Leiste nach unten ziehen, um die maximierte Ansicht anzuzeigen. mit zusätzlichen Inhalts- und Aktionsschaltflächen, sofern vorhanden. Beginnt in Unter Android 13 enthält diese erweiterte Ansicht eine Schaltfläche, über die Nutzer eine App mit laufendem Vordergrund beenden Dienste.
Eine Benachrichtigung bleibt auf der Benachrichtigungsleiste sichtbar, bis sie geschlossen wird. von der App oder dem Nutzer.
Vorabbenachrichtigung
Ab Android 5.0 können Benachrichtigungen kurz in einem unverankerten Bildschirm angezeigt werden. sogenannte Vorabbenachrichtigung. Dieses Verhalten tritt normalerweise bei wichtigen über die der Nutzer sofort informiert werden muss. Sie werden nur wenn das Gerät entsperrt ist.
Abbildung 3: Eine Vorabbenachrichtigung erscheint vor dem App im Vordergrund.
Die Vorabbenachrichtigung wird angezeigt, wenn Ihre App die Benachrichtigung ausgibt. Es verschwindet, aber in der Benachrichtigungsleiste Üblicherweise.
Folgende Bedingungen können Vorabbenachrichtigungen auslösen:
Die Aktivität des Nutzers erfolgt im Vollbildmodus, z. B. wenn die App
fullScreenIntent
Die Benachrichtigung hat eine hohe Priorität und verwendet Klingeltöne oder Vibrationen auf Geräte mit Android 7.1 (API-Level 25) und niedriger
Der Benachrichtigungskanal hat auf Geräten eine hohe Bedeutung. mit Android 8.0 (API-Level 26) oder höher.
Sperrbildschirm
Ab Android 5.0 können Benachrichtigungen auf dem Sperrbildschirm angezeigt werden.
Sie können programmatisch festlegen, ob von Ihrer App gepostete Benachrichtigungen auf einem Sperrbildschirm und, falls ja, die Detailgenauigkeit.
Nutzer können in den Systemeinstellungen festlegen, welche Detailstufe im Schloss angezeigt werden soll Bildschirmbenachrichtigungen deaktivieren oder alle Benachrichtigungen auf dem Sperrbildschirm deaktivieren. Beginnend mit Unter Android 8.0 können Nutzer die Benachrichtigungen auf dem Sperrbildschirm für die einzelnen Benachrichtigungskanal.
Abbildung 4: Benachrichtigungen auf dem Sperrbildschirm mit sensiblen Inhalten ausgeblendet.
Weitere Informationen finden Sie unter Sperrbildschirm einrichten. Sichtbarkeit.
Kennzeichen auf App-Symbolen
In unterstützten Launchern auf Geräten mit Android 8.0 (API-Level 26) und höher: App-Symbole kennzeichnen neue Benachrichtigungen mit einem farbigen Logo, dem sogenannten Benachrichtigungspunkt auf dem entsprechenden App Launcher-Symbol.
Nutzer können die ein App-Symbol gedrückt halten, um die Benachrichtigungen für diese App zu sehen. Nutzer*innen können über dieses Menü Benachrichtigungen schließen oder darauf reagieren, ähnlich wie die Benachrichtigung. Leiste.
Abbildung 5: Benachrichtigungskennzeichen und die Menü „Gedrückt halten“.
Weitere Informationen zur Funktionsweise von Badges findest du unter Benachrichtigungen ändern Badge.
Wear OS-Geräte
Wenn der Nutzer ein gekoppeltes Wear OS-Gerät hat, werden alle deine Benachrichtigungen dort angezeigt automatisch, einschließlich maximierbarer Details und Aktionsschaltflächen.
Sie können die Nutzererfahrung optimieren, indem Sie das Erscheinungsbild Ihres Benachrichtigungen auf Wearables und durch verschiedene Aktionen, darunter vorgeschlagene Antworten und Antworten per Spracheingabe Weitere Informationen hierzu finden Sie unter Hinzufügen von Funktionen speziell für Wearables Benachrichtigung.
Abbildung 6: Benachrichtigungen werden automatisch auf gekoppelten Wear OS-Geräten angezeigt .
Benachrichtigungsaufbau
Das Design einer Benachrichtigung wird durch Systemvorlagen und deine App bestimmt definiert den Inhalt für jeden Teil der Vorlage. Einige Details der werden nur in der erweiterten Ansicht angezeigt.
Abbildung 7: Eine Benachrichtigung mit grundlegenden Details.
Die häufigsten Bestandteile einer Benachrichtigung sind in Abbildung 7 so dargestellt:
- Kleines Symbol: erforderlich; festlegen mit
setSmallIcon()
- App-Name: vom System angegeben
- Zeitstempel: Wird vom System angegeben, kann aber überschrieben werden mit
setWhen()
oder blenden Sie ihn mitsetShowWhen(false)
. - Großes Symbol: optional; wird normalerweise nur für Kontaktfotos verwendet.
Verwenden Sie ihn nicht für Ihr App-Symbol. Festlegen mit
setLargeIcon()
- Title: optional; festlegen mit
setContentTitle()
- Text: optional; festlegen mit
setContentText()
Wir empfehlen dringend die Verwendung von Systemvorlagen, allen Geräten. Bei Bedarf können Sie eine benutzerdefinierte Benachrichtigung erstellen. Layout.
Weitere Informationen zum Erstellen einer Benachrichtigung mit diesen Funktionen und Weitere Informationen finden Sie unter Erstellen Benachrichtigung.
Benachrichtigungsaktionen
Es ist zwar nicht erforderlich, aber es empfiehlt sich, jede Benachrichtigung zu öffnen, beim Antippen eine entsprechende App-Aktivität. Zusätzlich zu dieser Standardeinstellung können Sie Aktionsschaltflächen hinzufügen, die eine App-bezogene aus der Benachrichtigung heraus – oft ohne eine Aktivität zu öffnen – wie in Abbildung 8 dargestellt.
Abbildung 8: Eine Benachrichtigung mit Aktionsschaltflächen.
Ab Android 7.0 (API-Level 24) kannst du eine Aktion zum Antworten hinzufügen oder anderen Text direkt in der Benachrichtigung eingeben.
Ab Android 10 (API-Level 29) kann die Plattform automatisch Aktionsschaltflächen mit vorgeschlagenen absichtsbasierten Aktionen.
Das Hinzufügen von Aktionsschaltflächen wird im Abschnitt Eine Kampagne erstellen Benachrichtigung.
Gerät ohne SIM-Lock erforderlich
Nutzer sehen möglicherweise Benachrichtigungsaktionen auf dem Sperrbildschirm des Geräts. Wenn ein eine Benachrichtigungsaktion veranlassen, dass eine App eine Aktivität startet oder Nutzer müssen das Gerät entsperren, bevor die App diese Benachrichtigungsaktion aufrufen kann.
Unter Android 12 (API-Level 31) und höher können Sie eine Benachrichtigungsaktion konfigurieren Das Gerät muss entsperrt sein, damit die App diese Aktion auslösen kann. egal, welchen Workflow die Aktion startet. Mit dieser Option wird eine zusätzliche Ebene für Benachrichtigungen auf gesperrten Geräten.
So legen Sie fest, dass ein Gerät entsperrt werden muss, bevor Ihre App eine bestimmte Benachrichtigung aufruft
Aktion, true
übergeben an
setAuthenticationRequired()
wenn Sie die Benachrichtigungsaktion erstellen, wie im folgenden Code-Snippet gezeigt:
Kotlin
val moreSecureNotification = Notification.Action.Builder(...) // This notification always requests authentication when invoked // from a lock screen. .setAuthenticationRequired(true) .build()
Java
Notification moreSecureNotification = new Notification.Action.Builder(...) // This notification always requests authentication when invoked // from a lock screen. .setAuthenticationRequired(true) .build();
Maximierbare Benachrichtigung
Der Textinhalt einer Benachrichtigung wird standardmäßig auf eine Zeile gekürzt. Wenn Sie möchten, dass Ihre Benachrichtigung länger ist, können Sie einen größeren Textbereich aktivieren. die mithilfe einer zusätzlichen Vorlage erweiterbar ist (siehe Abbildung 9).
Abbildung 9: Eine maximierbare Benachrichtigung für große Text.
Sie können auch eine maximierbare Benachrichtigung mit einem Bild im Posteingangsstil erstellen. mit einer Chatunterhaltung oder mit der Wiedergabesteuerung für Medien. Weitere Informationen Weitere Informationen finden Sie unter Erweiterbare Benachrichtigung erstellen.
Benachrichtigungsaktualisierungen und -gruppen
Damit Nutzer nicht mit mehreren oder redundanten Benachrichtigungen überschwemmt werden, Wenn Sie zusätzliche Updates haben, aktualisieren Sie als neue Nachrichten auszugeben oder das Format für den Posteingang Benachrichtigung zum Einblenden Benachrichtigungen zu Unterhaltungen.
Wenn jedoch mehrere Benachrichtigungen gesendet werden müssen, empfiehlt es sich, Gruppierungen die einzelnen Benachrichtigungen in einer Gruppe zusammenfassen, verfügbar ab Android 7.0.
Mit einer Benachrichtigungsgruppe können Sie mehrere Benachrichtigungen Benachrichtigungsleiste mit einer Zusammenfassung. Der Nutzer kann die Anzeige nach und nach und die dazugehörigen Benachrichtigungen erhalten Sie weitere Informationen. Abbildung 10.
Abbildung 10. Eine minimierte und eine maximierte Benachrichtigungsgruppe.
Informationen zum Hinzufügen von Benachrichtigungen zu einer Gruppe finden Sie unter Erstellen einer Gruppe von Benachrichtigungen.
Benachrichtigungskanäle
Ab Android 8.0 (API-Level 26) müssen alle Benachrichtigungen einer oder nicht angezeigt. Damit können Nutzer bestimmte Benachrichtigungen deaktivieren für Ihre App zu verwenden, anstatt alle Benachrichtigungen zu deaktivieren. Nutzer können die visuellen und akustischen Optionen für jeden Kanal über das Android-System steuern wie in Abbildung 11 dargestellt. Nutzer können auch die eine Benachrichtigung gedrückt halten, das Verhalten des verknüpften Kanals zu ändern.
Auf Geräten mit Android 7.1 (API-Level 25) und niedriger können Nutzer Benachrichtigungen nur für die jeweilige App. Jede App hat praktisch nur einen Kanal. Android 7.1 und niedriger.
Abbildung 11: Benachrichtigungseinstellungen für die Uhr App und einen ihrer Kanäle.
Eine App kann für jede Art von Benachrichtigung, die sie sendet, einen eigenen Kanal haben. Eine App kann auch Benachrichtigungskanäle als Reaktion auf Entscheidungen erstellen, die von Nutzenden. Beispielsweise können Sie für jeden Kanal einen separaten Unterhaltungsgruppe, die von einem Nutzer in einer Messaging-App erstellt wurde.
Auf dem Kanal legen Sie auch die Wichtigkeitsstufe auf Geräten mit Android 8.0 und höher, sodass alle Benachrichtigungen Benachrichtigungskanäle gleichzeitig verhalten. Dies wird im Folgenden beschrieben: .
Weitere Informationen finden Sie unter Benachrichtigungen erstellen und verwalten. Kanäle.
Wichtigkeit von Benachrichtigungen
Android nutzt die Wichtigkeit einer Benachrichtigung, um zu bestimmen, die den Nutzer visuell und akustisch unterbricht. Je höher die Wichtigkeit, desto mehr Unterbrechung ist die Benachrichtigung.
Auf Android-Geräten
7.1 (API-Ebene 25) und niedriger wird die Wichtigkeit einer Benachrichtigung durch
der Benachrichtigung
priority
Unter Android 8.0 (API-Level 26) und höher ist die Wichtigkeit einer Benachrichtigung
durch die
importance
des Kanals, auf dem die Benachrichtigung gepostet wird. Nutzende können die Wichtigkeit
in den Systemeinstellungen einen Benachrichtigungskanal einrichten (siehe Abbildung 12).
Abbildung 12. Nutzer können die Wichtigkeit der einzelnen Kanäle auf Android-Geräten ändern. 8.0 und höher.
Die möglichen Wichtigkeitsstufen und das zugehörige Benachrichtigungsverhalten Folgendes:
Dringend: akustisches Signal ertönt und Vorabbenachrichtigung wird angezeigt.
Hoch: Ein akustisches Signal ertönt.
Mittel: kein akustisches Signal
Niedrig: kein akustisches Signal ertönt und erscheint nicht in der Statusleiste.
Alle Benachrichtigungen, unabhängig von ihrer Wichtigkeit, werden im nicht störenden System angezeigt. Positionen auf der Benutzeroberfläche, z. B. in der Benachrichtigungsleiste und als Badge im Launcher . Sie können jedoch das Aussehen der Benachrichtigung Badge.
Weitere Informationen hierzu finden Sie im Artikel zum Festlegen der Bedeutung.
Modus "Bitte nicht stören"
Ab Android 5.0 (API-Level 21) können Nutzer den Modus „Bitte nicht stören“ aktivieren. wodurch Ton und Vibrationen für alle Benachrichtigungen stummgeschaltet werden. Benachrichtigungen stehen still werden wie gewohnt in der Systembenutzeroberfläche angezeigt, sofern der Nutzer nichts anderes festlegt.
Im Modus „Bitte nicht stören“ sind drei Stufen verfügbar:
- Lautlos: Alle Töne und Vibrationen werden blockiert, auch Wecker Musik, Videos und Spiele.
- Nur Wecker: Akustische Signale und Vibrationen werden blockiert, mit Ausnahme von Weckern.
- Nur wichtige: Nutzer können festlegen, welche systemweiten Kategorien z. B. Wecker, Erinnerungen, Termine, Anrufe oder Nachrichten. Bei Nachrichten und Anrufen können Nutzer nach Absender oder Anrufer filtern, wie hier gezeigt in Abbildung 13.
Abbildung 13. Nutzer können Benachrichtigungen über systemweite Kategorien (links) und Absender oder Anrufer (rechts).
Unter Android 8.0 (API-Level 26) und höher können Nutzer zusätzlich Benachrichtigungen für App-spezifische Kategorien erhalten, ändern, indem Sie „Bitte nicht stören“ für jeden Kanal überschreiben. Für So kann eine Zahlungs-App Kanäle für Benachrichtigungen in Bezug auf Abhebungen und Einzahlungen. Der Nutzer kann Abhebungsbenachrichtigungen, Einzahlungen Benachrichtigungen oder im Prioritätsmodus beides.
Auf Geräten mit Android 7.1 (API-Level 25) und niedriger können Nutzer nicht für einzelne Apps, sondern nur für einzelne Apps. für jeden einzelnen Kanal.
Um Ihre Benachrichtigungen für diese Nutzereinstellungen zu konfigurieren, müssen Sie eine systemweit Kategorie.
Benachrichtigungen für Vordergrunddienste
Eine Benachrichtigung ist erforderlich, wenn deine App im Vordergrund ausgeführt wird.
Dienst: ein Service
, der im
einen langlebigen und auffälligen Hintergrund haben,
Player. Diese Benachrichtigung kann nicht wie andere Benachrichtigungen geschlossen werden. Entfernen
In der Benachrichtigung muss der Dienst angehalten oder aus dem Vordergrund entfernt werden.
Bundesstaat.
Weitere Informationen finden Sie unter Vordergrund Dienste. Wenn Sie eine Mediendatei Weitere Informationen finden Sie unter Medien im Hintergrund abspielen.
Limits für Beiträge
Ab Android 8.1 (API-Level 27) können Apps keinen Benachrichtigungston ausgeben mehr als einmal pro Sekunde. Wenn Ihre App mehrere Benachrichtigungen in einer sendet Zweitens werden sie alle wie erwartet angezeigt, aber nur die erste Benachrichtigung pro Sekunde ein Geräusch macht.
Darüber hinaus wird eine Ratenbegrenzung angewendet, wenn eine Benachrichtigung aktualisiert wird. Wenn Sie zu häufig Updates zu einer einzelnen Benachrichtigung veröffentlichen, z. B. viele in weniger als eine Sekunde warten, werden Updates möglicherweise vom System installiert.
Benachrichtigungskompatibilität
Die Benutzeroberfläche des Android-Benachrichtigungssystems und die APIs zur Benachrichtigung
entwickeln können. Um die neuesten Funktionen der Notification API zu verwenden und gleichzeitig ältere
die Support Library Notification API verwenden,
NotificationCompat
,
und den zugehörigen abgeleiteten Klassen,
NotificationManagerCompat
So vermeiden Sie das Schreiben von bedingtem Code zum Prüfen von API-Ebenen, da diese
APIs kümmern sich darum.
NotificationCompat
wird im Zuge der Weiterentwicklung der Plattform aktualisiert und enthält nun die neuesten
. Die Verfügbarkeit einer Methode in NotificationCompat
dass die entsprechende Funktion auf älteren Geräten zur Verfügung steht. In einigen
-Fälle führt der Aufruf einer neu eingeführten API auf älteren Geräten zu einem Null-Vorgang.
Im Folgenden finden Sie eine Zusammenfassung der wichtigsten Verhaltensänderungen nach API-Ebene für Android-Benachrichtigungen.
Android 5.0, API-Ebene 21
Sperrbildschirm und Vorabbenachrichtigungen werden eingeführt.
Ermöglicht es dem Nutzer, das Telefon in den Modus „Bitte nicht stören“ zu versetzen und festzulegen, Benachrichtigungen dürfen sie unterbrechen, wenn sich das Gerät im Prioritätsmodus festlegen.
Es werden Methoden hinzugefügt, mit denen Sie festlegen können, ob eine Benachrichtigung auf dem Sperrbildschirm zum Beispiel
setVisibility()
), und eine öffentliche Version des Benachrichtigungstextes angeben.Fügt die Methode
setPriority()
hinzu, die dem System mitteilt, wie störend die Benachrichtigung. Wenn Sie beispielsweise die Priorität auf „Hoch“ setzen, werden als Vorabbenachrichtigungen angezeigt.Android Wear (jetzt Wear OS) unterstützt Benachrichtigungsstacks Geräte. Platzieren Sie Benachrichtigungen in einem Stapel mit
setGroup()
Benachrichtigungsstacks, die später als Gruppe oder Bundle bezeichnet werden, werden auf folgenden Geräten nicht unterstützt: Tablets oder Smartphones bis Android 7.0 (API-Level 24) verfügbar.
Android 7.0, API-Ebene 24
Die Benachrichtigungsvorlagen werden umgestaltet, um das Hero-Image hervorzuheben und Avatar.
Es werden drei Benachrichtigungsvorlagen hinzugefügt: eine für Messaging-Apps und die anderen beiden. zum Gestalten benutzerdefinierter Inhaltsansichten mit erweiterbaren Angeboten und anderen System-Dekorationen.
Unterstützt Handheld-Geräte wie Smartphones und Tablets Benachrichtigungsgruppen. Verwendet dieselbe API wie Android Wear (jetzt „Wear“ genannt). Betriebssystem) Benachrichtigungsstacks, die mit Android 5.0 (API-Level 21) eingeführt wurden.
Damit können Nutzer mit Inline-Antworten innerhalb einer Benachrichtigung antworten. Sie können an der der an die übergeordnete App der Benachrichtigung weitergeleitet wird.
Android 8.0 (API-Ebene 26)
Sie können festlegen, dass einzelne Benachrichtigungen in eine bestimmte channel verknüpft ist.
Damit können Nutzer nicht alle Benachrichtigungen für einzelne Kanäle deaktivieren. Benachrichtigungen von einer App.
Apps mit aktiven Benachrichtigungen zeigen ein Benachrichtigungskennzeichen über App-Symbol auf dem Start- oder Launcher-Bildschirm.
Damit können Nutzer die Schlummerfunktion für Benachrichtigungen in der Leiste aktivieren. Sie können eine automatische für eine Benachrichtigung.
Hier können Sie die Hintergrundfarbe der Benachrichtigung festlegen.
Verschiebt einige APIs bezüglich des Benachrichtigungsverhaltens von
Notification
bisNotificationChannel
Verwenden Sie beispielsweiseNotificationChannel.setImportance()
anstelle vonNotificationCompat.Builder.setPriority()
für Android 8.0 und höher.
Android 13.0, API-Level 33
- Fügt runtime hinzu Berechtigung Für Ihr App zum Senden nicht ausgenommen Benachrichtigungen erhalten, muss der Nutzer Ihrer App diese Berechtigung erteilen.
Android 14.0, API-Level 34
Beschränkt Vollbild-Intent-Benachrichtigungen auf Apps, die Anrufe und Alarme. Verwenden Sie die
NotificationManager.canUseFullScreenIntent
API für Folgendes: prüfen, ob Ihre App die Berechtigung hat. Falls nicht, kann Ihre AppACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
, um die Seite „Einstellungen“ zu öffnen in dem Nutzer die Berechtigung erteilen können.Ändert die Art und Weise, wie Nutzer Benachrichtigungen sehen, die nicht geschlossen werden können, indem sie die Benachrichtigungen selbst dann zu schließen, Das Flag
Notification.FLAG_ONGOING_EVENT
ist gesetzt. Dies gilt nicht fürCallStyle
-Benachrichtigungen, wenn das FlagNotification.FLAG_ONGOING_EVENT
gleich Device Policy Controller (DPC) und unterstützende Pakete für Unternehmen. Dies gilt auch nicht, wenn das Smartphone gesperrt ist Der Nutzer wählt Alle löschen aus.