Unterhaltungsbenachrichtigungen und ‑Widgets

In Android 11 können Sie das Verhalten und die Platzierung von Unterhaltungsbenachrichtigungen im Benachrichtigungs-Schieberegler nach Priorität und Benachrichtigungsstufe anpassen. So können Unterhaltungen als wichtig gekennzeichnet und unterhaltungsspezifische Bubbles im Unterhaltungsbereich gestartet werden.

Android 12 baut auf diesen Funktionen von Android 11 auf und bietet zwei neue Funktionen für Unterhaltungen:

  • Mit der Funktion „Letzte Unterhaltungen“ in den Einstellungen können Nutzer das Benachrichtigungsverhalten für letzte Unterhaltungen anpassen, ohne auf eine Benachrichtigung zu warten.

  • Mit dem Unterhaltungs-Widget können Nutzer ganz einfach Chats auf dem Startbildschirm öffnen und sich einen schnellen Überblick über die letzten Unterhaltungen verschaffen.

In diesem Dokument werden die Implementierung, Anpassung und Validierung von Benachrichtigungen und Widgets für Unterhaltungen beschrieben.

Unterhaltungsbenachrichtigungen – Übersicht

In Android 11 wird ein neues Systemprimitiv eingeführt: die Unterhaltung. Sie wird durch das vorhandene Objekt für die Freigabeverknüpfung dargestellt, das mit Android 9 eingeführt wurde.

Das Element „Unterhaltungen“ kann so verwendet werden:

  • Über das Freigabe-Widget können jetzt auch Konversationsdaten zwischen den Apps im System geteilt werden (bereits in Android 10 verfügbar).

  • Für Bubbles(Verknüpfungen) für das Fahren unter Android 11. Siehe Abbildung 1.

  • Sie können am neuen Unterhaltungsbereich über dem Benachrichtigungs-Schieberegler teilnehmen (in Android 11 implementiert). Siehe Abbildung 2.

  • Zum Erstellen von Kommunikations-Widgets (in Android 12 implementiert).

    conv_bubbles

    Abbildung 1:Benachrichtigung, die als Bubble aus der Benachrichtigungsleiste gestartet wird

    conv_notification

    Abbildung 2:Unterhaltungsbereich oben in der Benachrichtigungsleiste

Neben dem Link zum Verknüpfen mit dem Symbol für die Unterhaltung wird in der Benachrichtigung auch MessagingStyle verwendet, um die letzte Nachricht der Unterhaltung im Unterhaltungsbereich einzubinden.

GMS-Partner müssen Folgendes implementieren:

  • Ein neuer Bereich für Unterhaltungen als separater Bereich oben im Benachrichtigungs-Schieberegler.
  • Ein Benachrichtigungsstil, der das unterhaltungsspezifische Bubble-Muster zulässt und unterstützt.

Partner, die Konversationen implementieren, müssen auch wichtige Konversationen implementieren. Die Implementierung von Unterhaltungen kann jedoch an ähnliche OEM-Konzepte angepasst werden. Partner können den Bereich für Unterhaltungen an ihre spezifische System-UI anpassen. Der Partner muss weder HAL-/Treiber-/Kernel-Code noch -Erweiterungen ändern oder implementieren.

Weitere Informationen finden Sie in den Abschnitten „SystemUI“ und „PeopleService“ im AOSP:

frameworks/base/packages/SystemUI/src/com/android/systemui/people/
frameworks/base/core/java/android/app/people/
frameworks/base/services/people/java/com/android/server/people/

Zertifizierungsstufe

Prüfen Sie Folgendes, um sicherzustellen, dass Ihre Version der Funktion wie vorgesehen funktioniert:

  1. Für Apps, die die Conversation API vollständig unterstützen, werden die Benachrichtigungen im neuen Bereich angezeigt. Sie können diese Benachrichtigungen nach Unterhaltung und nicht nach dem generischen NotificationChannel anpassen.

  2. Unterhaltungsspezifische Bubbles funktionieren.

Verwenden Sie die folgenden Tests im Benachrichtigungspaket, um die Implementierung zu validieren:

  • CTS-Tests

    cts/tests/app/src/android/app/cts/NotificationManagerTest.java

  • CTS-Verifier-Tests

    cts/apps/CtsVerifier/src/com/android/cts/verifier/notifications/

Unterhaltungs-Widgets

In Android 12 baut die Funktion „Unterhaltungs-Widget“ auf den Unterhaltungsdarstellungen auf, die in Android 11 erstellt wurden (wie im vorherigen Abschnitt beschrieben). Apps können damit den Status für Unterhaltungen angeben, die in Unterhaltungs-Widgets angezeigt werden.

conv_widgets

Abbildung 3:Unterhaltungen in Unterhaltungs-Widgets

Mit dem Konversations-Widget in Android 12 können Nutzer ganz einfach auf dem Startbildschirm Chats öffnen. Die Widgets sind erweiterte Verknüpfungen, mit denen Nutzer schnell zu ihren Unterhaltungen zurückkehren können. Außerdem werden Snippets der Unterhaltungsstatus angezeigt.

Der Partner muss Folgendes implementieren:

  1. Ein von SystemUI bereitgestelltes Widget.
  2. Einen Ablauf zum Hinzufügen dieser Widgets über den Bildschirm zur Auswahl von Widgets.
  3. Unterstützung für die Anpassung der Widget-Größe:

Beachten Sie bei der Implementierung von Unterhaltungs-Widgets die folgenden Abhängigkeiten:

  • Der Partner muss den HAL-/Treiber-/Kernel-Code nicht ändern oder implementieren.
  • Für die Implementierung wird die Status API verwendet, mit der Apps Status- oder Verfügbarkeitsinformationen zu einer Unterhaltung und dem zugehörigen Widget hinzufügen können.
  • Der Vorgang ist sowohl bei der Implementierung neuer Geräte als auch bei der Implementierung von Upgrades identisch.
  • Die Funktion „Unterhaltungs-Widgets“ ist von einer neuen Funktion abhängig, die in Android 12 eingeführt wird und kürzlich aufgerufene Unterhaltungen (z. B. aus Benachrichtigungen) im Cache speichert. Mit dieser Funktion lässt sich die Liste der Unterhaltungen erweitern, die Nutzer ihrem Startbildschirm hinzufügen können.

Weitere Informationen finden Sie in den folgenden Referenzimplementierungen in den Dateien „SystemUI“ und „Launcher3“:

frameworks/base/packages/SystemUI/src/com/android/systemui/people/
frameworks/base/core/java/android/app/people/
frameworks/base/services/people/java/com/android/server/people/

Personalisierung

Die Funktion „Unterhaltungs-Widgets“ kann nicht aktiviert oder deaktiviert werden. Partner können jedoch die Layouts der Widget-Vorlagen ändern, sofern die GMS-Anforderungen erfüllt sind.

Zertifizierungsstufe

Prüfen Sie Folgendes, um sicherzustellen, dass Ihre Version der Funktion wie vorgesehen funktioniert:

  1. Wenn Sie lange auf den Launcher drücken, können Sie über die Widget-Auswahl ein neues Conversation-Widget für eine Unterhaltung hinzufügen. Abbildung 4 zeigt die Benutzeroberfläche der Widget-Auswahl:

    widget_picker

    Abbildung 4:Benutzeroberfläche der Widget-Auswahl zum Hinzufügen eines neuen Konversations-Widgets

  2. Wenn Benachrichtigungen von der ausgewählten Unterhaltung an das Gerät gesendet werden, wird das Widget entsprechend aktualisiert.

  3. Wenn Sie der Unterhaltung mithilfe der ConversationStatus API Status zuweisen, werden diese im Widget angezeigt.

  4. Nutzer können die Größe von Widgets ändern und die Größe von Widgets kann sich je nach aktuellem Launcher ändern. Ihre Widget-Layouts müssen gut mit verschiedenen Launcher-Größen auf verschiedenen Geräten und bei der Größenänderung des Widgets funktionieren.

Verwenden Sie die folgenden Tests im Benachrichtigungspaket, um die Implementierung zu validieren:

  • CTS-Tests (PeopleManagerTest) für die API-Oberflächen.

    cts/tests/app/src/android/app/cts/NotificationManagerTest.java

  • Manuelle Tests für GMS-Anforderungen – Unterhaltungen