Personen und Unterhaltungen

Die Initiative „Personen und Unterhaltungen“ ist eine mehrjährige Android-Initiative, die darauf abzielt, Personen und Unterhaltungen auf den Systemoberflächen des Smartphones hervorzuheben. Diese Priorität beruht auf der Tatsache, dass die Kommunikation und Interaktion mit anderen Die Menschen sind nach wie vor für die Mehrheit unserer Nutzer*innen aus allen demografischen Gruppen.

In Android 11 wurden mehrere Funktionen eingeführt, die die Initiative „Personen und Unterhaltungen“ unterstützen.

Unterhaltungsbereich


Der Unterhaltungsbereich ist ein spezieller Benachrichtigungsbereich für Echtzeitinformationen. zwischen Menschen kommunizieren.
Abbildung 1: Der Konversationsbereich

Auf Handheld-Geräten gibt es über der Benachrichtigung einen separaten Bereich. Schattierung, die nur Echtzeit-Unterhaltungen mit Personen enthält (z. B. Anrufe und Chatnachrichten, einschließlich Gruppenchats). Benachrichtigungen in diesem Gruppenbereich sehen auf vielen Smartphones anders aus und funktionieren anders als Benachrichtigungen, die nicht zu einer Unterhaltung gehören:

  • Das Design ist anders, wobei der Avatar einen starken Schwerpunkt auf dem Avatar liegt, der die zusammen mit der App, die die Unterhaltung führt.
  • Wenn Sie auf die Benachrichtigung tippen, Konversation in der App (oder Bubble, wenn der Unterhaltung zuvor als Bubble angezeigt wurde), und durch Tippen auf das Caret-Zeichen werden neue Nachrichten in der Leiste auf die vollständige Länge erweitert. mit einer vollständigen Liste der Optionen.
  • Es werden konversationsspezifische Aktionen angeboten (einige durch langes Drücken):
    • Diese Unterhaltung als Priorität markieren
    • Diese Unterhaltung als Bubble anzeigen (nur angezeigt, wenn die App Bubbles unterstützt)
    • Benachrichtigungen für diese Unterhaltung stummschalten
    • Benutzerdefinierte Töne oder Vibrationen für diese Unterhaltung festlegen

Unterhaltungen in Bubbles

Wenn eine Benachrichtigung die Anforderungen für Unterhaltungen erfüllt, wird es als Bubble in der Benachrichtigungsleiste geöffnet.
Abbildung 2: Eine Benachrichtigung wird als Bubble aus der Benachrichtigungsleiste gestartet.

Ab Android 11 können Bubbles über Benachrichtigungen im Bereich „Unterhaltungen“ gestartet werden. Nur Benachrichtigungen mit einem verknüpften Kurzbefehl können als Bubbles angezeigt werden. Konversationen werden automatisch als Bubble angezeigt, wenn sie als wichtig markiert sind oder im Benachrichtigungs-Shade als Bubble angezeigt werden.

Kurzbefehle für Unterhaltungen

Verknüpfungen für Unterhaltungen werden im Launcher und neben langlebig sind, Tastenkombinationen zum Teilen im Sharesheet finden.

API-Richtlinien

In diesem Abschnitt werden die APIs beschrieben, mit denen Sie in Ihrer App Unterstützung für den systemeigenen Bereich hinzufügen können, in dem Personen und Unterhaltungen angezeigt werden.

Tastenkombinationen für Unterhaltungen

Für die Teilnahme an dieser gesprächsorientierten Initiative müssen Apps um dem System eine langlebig Tastenkombinationen. Wir empfehlen dringend, langlebige Verknüpfungen für die Freigabe zu verwenden. Unter Android 11 können Sie bei Bedarf dynamische Verknüpfungen verwenden. Diese Option wird jedoch möglicherweise in Zukunft entfernt.

Wenn Sie einen Verknüpfungs-Shortcut für die Unterhaltung veröffentlichen möchten, rufen Sie die Methoden ShortcutManagerCompat setDynamicShortcuts(), addDynamicShortcuts() oder pushDynamicShortcut() auf. Letztere verwaltet das Limit für Verknüpfungs-Shortcuts automatisch für den Entwickler. Diese Tastenkombination muss langlebig und haben Person angehängten Daten für eine oder mehrere Personen zur Identifizierung der anderen Teilnehmenden Gespräch. Wir empfehlen außerdem, LocusIdCompat festzulegen.

Wenn eine Unterhaltung nicht mehr vorhanden ist, kann die App den Verknüpfungs-Shortcut mit removeLongLivedShortcuts() löschen. Dadurch werden alle mit der Unterhaltung verknüpften Daten vom System gelöscht. Verknüpfungen können zwar entfernt werden, dürfen aber keine im Cache gespeicherten Verknüpfungen von Apps entfernen es sei denn, es ist absolut notwendig. wird eine Verknüpfung wahrscheinlich im Cache gespeichert, mit ihr interagiert hat, um die Nutzererfahrung zu ändern. Wenn Sie die Verknüpfung entfernen, Änderungen rückgängig zu machen, was zu Frustration bei den Nutzern führt.

Unterhaltungsbenachrichtigungen

Eine Benachrichtigung gilt als Unterhaltungsbenachrichtigung, wenn Folgendes zutrifft:

  • In der Benachrichtigung wird MessagingStyle verwendet.

  • (Nur wenn die App auf Android 11 oder höher ausgerichtet ist) Das ist mit einem gültigen langlebig dynamische oder im Cache gespeicherte Freigabeverknüpfung. Die Benachrichtigung kann diese Verknüpfung festlegen, indem sie setShortcutId() oder setShortcutInfo(). Wenn die App auf Android 10 oder niedriger ausgerichtet ist, muss die Benachrichtigung nicht mit einer Verknüpfung verknüpft sein, wie im Abschnitt Fallback-Optionen erläutert.

  • Der Nutzer hat die Unterhaltung nicht mithilfe von Einstellungen für den Benachrichtigungskanal.

LocusIdCompat verwenden

Anhand der On-Device-Intelligenz werden die Unterhaltungen ermittelt, an denen der Nutzer am wahrscheinlichsten interessiert ist. Zu den wichtigsten Signalen gehören Aktualität und Die Häufigkeit der Unterhaltungssitzungen in den einzelnen Unterhaltungen. Das System weiß, über Interaktionen mit einer Unterhaltung über Launcher-Verknüpfungen oder in einem ob sie richtig getaggt sind. Das System weiß jedoch nichts über Unterhaltungen, die vollständig in der App stattgefunden haben, es sei denn, diese Interaktionen sind ebenfalls getaggt. Daher empfehlen wir dringend, dass Sie LocusIdCompat an die Tastenkombination und die In-App-Aktivität bzw. das Fragment mit dem verknüpfte LocusIdCompat. LocusIdCompat verwenden damit das Vorschlagssystem eine Konversation richtig einstufen und um die korrekte Zeit der letzten Interaktion des Nutzers anzuzeigen (einschließlich In-App-Interaktionen) mit einer Unterhaltung. Wenn Sie setShortcutInfo() die Unterhaltung mit einer Verknüpfung verknüpfen, hängt automatisch die entsprechende LocusIdCompat an.

Anforderungen an Gruppenbereiche für Apps, die auf Android 10 oder niedriger ausgerichtet sind

Wenn eine App nicht auf Android 11 ausgerichtet ist, können ihre Nachrichten trotzdem im Unterhaltungsbereich angezeigt. Die App muss jedoch weiterhin bestimmte Anforderungen. In diesem Abschnitt werden die Anforderungen für diese Apps sowie die Fallback-Verhalten verursacht, wenn die App die Anforderungen nicht erfüllt.

Die wichtigste Voraussetzung für die Teilnahme am Messaging-Bereich ist, dass die App MessagingStyle implementieren Benachrichtigungen und die Benachrichtigungen müssen auf eine langlebige Verknüpfung aus der Benachrichtigung, die am wann die Benachrichtigung gepostet wird. Benachrichtigungen, die diese Anforderungen erfüllen werden im Unterhaltungsbereich so angezeigt:

  • Die Benachrichtigung wird im Konversationsstil angezeigt.
  • Schaltfläche Bubble wird angezeigt, sofern implementiert
  • Unterhaltungsspezifische Funktionen werden inline angeboten.

Wenn die Benachrichtigung diese Anforderungen nicht erfüllt, verwendet die Plattform Fallback-Optionen, um die Benachrichtigung zu formatieren. Wenn eine Benachrichtigung die Anforderungen In beiden Fällen wird die Benachrichtigung im Unterhaltungsbereich angezeigt mit spezieller Formatierung. Wenn in der Benachrichtigung Fallback-Option ist, wird sie nicht im Unterhaltungsbereich angezeigt.

Fallback: Wenn „MessagingStyle“ verwendet wird, aber keine Tastenkombination angegeben ist

Wenn die App auf Android 10 oder niedriger ausgerichtet ist und in einer Benachrichtigung MessagingStyle aber die Nachricht nicht mit einer Verknüpfung verknüpft, wird die Benachrichtigung wird wie folgt im Gruppenbereich der Unterhaltung angezeigt:

  • Benachrichtigung wird im Unterhaltungsstil angezeigt
  • Es wird keine Blasenschaltfläche angezeigt.
  • Inline werden keine unterhaltungsspezifischen Funktionen angeboten.

Fallback: Wenn MessagingStyle nicht verwendet wird, die App aber eine anerkannte Messaging-App ist

Wenn für eine Benachrichtigung keine MessagingStyle aber die App wird von der Plattform als Messaging-App erkannt. category auf msg, Die Benachrichtigung wird mit folgendem Verhalten im Gruppenbereich der Unterhaltung angezeigt:

  • Benachrichtigung wird in einem älteren Stil angezeigt, der älter als Android 11 war
  • Es wird keine Blasenschaltfläche angezeigt.
  • Keine unterhaltungsspezifischen Funktionen werden inline angeboten.

Hinweise, Verwendung und Tests

Dieser Abschnitt enthält eine allgemeine Anleitung zum Verwenden und Testen der Unterhaltungsfunktionen.

Wann sollte ich Konversationen verwenden?

Unterhaltungsbenachrichtigungen und zugehörige Tastenkürzel sollen die Nutzerfreundlichkeit von Unterhaltungen in Echtzeit verbessern. SMS, Textchats und Telefonanrufe sind beispielsweise Echtzeitunterhaltungen, bei denen Nutzer eine schnelle Kommunikation erwarten. Nutzende haben nicht diese Erwartung, wenn E-Mails und Aktivitäten nicht im Zusammenhang stehen. zu Unterhaltungen führen.

Wir haben Nutzern die Möglichkeit gegeben, eine bestimmte Unterhaltung aus der wenn sie das Gefühl hat, nicht am richtigen Ort zu sein.

Best Practices

Um die Interaktion zu steigern und es Nutzern zu erleichtern, mit anderen Nutzern und Unterhaltungen zu Ihrer App zu interagieren, empfehlen wir die folgenden Best Practices.

  • Damit verpasste Anrufe in der priorisierten Unterhaltung angezeigt werden schattiert und richtig in der Conversion-Widget, Benachrichtigungen zu verpassten Anrufen formatieren als conversations mit einem Kategorie auf CATEGORY_MISSED_CALL festgelegt.
  • Stellen Sie Nutzern hochwertige Avatare (104 dp) zur Verfügung. Andernfalls verwendet das System die Initialen der Person, was weniger ansprechend ist.
  • Das sollten Sie vermeiden cancel: bevor der Nutzer die Nachricht nicht gesehen hat. Eins Beispiel: Eine Benachrichtigung abbrechen, wenn die App in einer Ansicht geöffnet wird an denen der Nutzer die Nachricht nicht sehen oder adressieren kann. Wenn der Nutzer nicht die Möglichkeit hat, die Nachricht zu lesen oder zu beantworten, werden eine abgebrochene Benachrichtigung und die zugehörige Bubble entfernt. Dadurch geht der Unterhaltungskontext verloren.
  • Geben Sie data URI für MIME-bezogene Metadaten, die Nachrichten zugeordnet sind. Damit erhalten Sie die um Benachrichtigungen noch vielfältiger zu gestalten.
  • Mit der Android 12 status API können Sie Unterhaltungs-Widgets ansprechender gestalten.
  • Befolgen Sie die folgenden Best Practices für Tastenkombinationen für Unterhaltungen
    • Tastenkombinationen für eingehende und ausgehende In-App-Unterhaltungen veröffentlichen, für die keine Push-Benachrichtigungen gesendet werden Eingehende und ausgehende Nachrichten für denselben dieselbe Verknüpfungs-ID haben. Verwenden Sie pushDynamicShortcut(), um Ihre Tastenkürzel zu veröffentlichen und die Nutzung zu melden.
    • Um zu vermeiden, dass der Avatar deines Kurzbefehls unbeabsichtigt abgeschnitten wird, solltest du eine AdaptiveIconDrawable auf das Symbol der Verknüpfung. Weitere Informationen finden Sie unter Verknüpfungsbilder bereitstellen.
    • Damit das System Ihren Shortcut bestmöglich präsentieren kann, folgen Sie den Richtlinien für das beste Ranking. Die Rangfolge deiner Verknüpfung wird auf verschiedenen Systemoberflächen ermittelt, u. a. auf dem Android- Sharesheet, wenn es ein Kurzbefehl zum Teilen ist.
    • Achten Sie darauf, dass Tastenkombinationen zum Öffnen von Unterhaltungen intents direkt zur entsprechenden Unterhaltung führen.
    • Mit den kompatiblen Bibliotheken kannst du deine Tastenkürzel ganz einfach als conversation-verwandt festlegen.

Unterhaltungsbenachrichtigungen und Tastenkombinationen testen

Durch langes Drücken auf eine Konversation wird ein Menü mit gesprächsbezogenen Aktionen.
Abbildung 3: Sie können prüfen, ob eine Unterhaltungsbenachrichtigung richtig konfiguriert ist, indem Sie lange darauf drücken und prüfen, ob das Unterhaltungsmenü angezeigt wird.

Wenn Sie sich an die Richtlinien für Gruppenbereiche halten, Unterhaltungen sollten automatisch im Unterhaltungsbereich angezeigt werden. Sie können überprüfen, ob die Verknüpfung korrekt integriert ist, indem Sie lange auf . Wenn die Integration korrekt durchgeführt wurde, wird in der Benutzeroberfläche gesprächsbezogenen Aktionen. Wenn die Benachrichtigung nicht mit einem Shortcut verknüpft ist, wird auf der Benutzeroberfläche angezeigt, dass die App keine Konversationsfunktionen unterstützt.

Hinzugefügte Verknüpfungen werden angezeigt, wenn Sie den App Launcher lange gedrückt halten. Überprüfe, ob dich die Verknüpfungen an die richtige Stelle in der

Hinzugefügte Kurzbefehle zum Teilen werden in der Zeile „Direkt teilen“ des Freigabebereichs angezeigt, wenn Sie Inhalte teilen, die Ihr Kurzbefehl zum Teilen empfangen kann.

Kommunikations-Widgets

Unterhaltungen, die in Unterhaltungs-Widgets angezeigt werden
Abbildung 1: In Konversations-Widgets angezeigte Konversationen.

In Android 12 baut die Funktion des Konversations-Widgets auf den Personen und Unterhaltungsfunktion mit Android 11 eingeführt indem Sie Apps erlauben, den Unterhaltungsstatus in Unterhaltungs-Widgets anzuzeigen.

Konversations-Widgets fördern die Nutzerinteraktion, da sie sich einfach öffnen lassen Chats auf dem Startbildschirm angezeigt. Bei diesen Widgets handelt es sich um erweiterte Verknüpfungen, mit denen Nutzer um effizient zu ihren Unterhaltungen zurückzukehren und dabei Ausschnitte ihrer Unterhaltungsstatus oder andere relevante Informationen.

Prüfen, ob Ihre App Konversations-Widgets unterstützt

Um zu prüfen, ob Ihre App Konversations-Widgets unterstützt, benötigen Sie mindestens zwei Android-Geräte (beide mit Android 12) und zwei Nutzerkonten (jeweils eines auf jedem Gerät), um Nachrichten auszutauschen. Für diesen Vorgang nennen wir die Konten „Nutzer A“ und „Nutzer B“.

Benutzeroberfläche der Widgetauswahl, um ein neues Unterhaltungs-Widget hinzuzufügen
Abbildung 2: Benutzeroberfläche der Widgetauswahl zum Hinzufügen eines neuen Konversations-Widgets.

Führe dann die folgenden Schritte durch:

  1. Drücken Sie auf dem Gerät von Nutzer A lange auf den Launcher. Tippen Sie in der Widget-Auswahl auf ein neues Widget für eine Unterhaltung (siehe Abbildung 2).
  2. Ziehen Sie das Widget auf den Startbildschirm. Eine Liste der aktiven oder letzten Unterhaltungen aus der App von Nutzer A sollte auswählbar sein.
  3. Senden Sie jetzt auf dem Gerät von Nutzer B eine Testnachricht an Nutzer A.
  4. Prüfen Sie auf dem Gerät von Nutzer A, ob das Widget aktualisiert wurde, um die Benachrichtigung über die Nachricht von Nutzer B widerzuspiegeln.
  5. Optional: Legen Sie für Nutzer A und Nutzer B unterschiedliche Statuswerte für die Unterhaltung fest, damit sie in den Widgets korrekt angezeigt werden. Eine Liste der Statuswerte finden Sie unter ConversationStatus.