Notification.Builder.SetShortcutId(String) Methode

Definition

In Android 11 können Nachrichtenbenachrichtigungen (die MessagingStyle verwenden), die diese Methode verwenden, um eine Verknüpfung mit einer veröffentlichten, langlebigen Freigabeverknüpfung zu verknüpfen, in einem dedizierten Abschnitt "Unterhaltung" des Shades angezeigt werden und konfigurationsoptionen anzeigen, die für Unterhaltungen eindeutig sind.

[Android.Runtime.Register("setShortcutId", "(Ljava/lang/String;)Landroid/app/Notification$Builder;", "GetSetShortcutId_Ljava_lang_String_Handler", ApiSince=26)]
public virtual Android.App.Notification.Builder SetShortcutId(string? shortcutId);
[<Android.Runtime.Register("setShortcutId", "(Ljava/lang/String;)Landroid/app/Notification$Builder;", "GetSetShortcutId_Ljava_lang_String_Handler", ApiSince=26)>]
abstract member SetShortcutId : string -> Android.App.Notification.Builder
override this.SetShortcutId : string -> Android.App.Notification.Builder

Parameter

shortcutId
String

Zeichenfolge: Die ID der Verknüpfung, mit der diese Benachrichtigung verknüpft ist

Gibt zurück

Diese Android.App.Notification.Builder-Instanz, sodass Anrufe verkettet werden können.

Attribute

Hinweise

In Android 11 können Nachrichtenbenachrichtigungen (die MessagingStyle verwenden), die diese Methode verwenden, um eine Verknüpfung mit einer veröffentlichten, langlebigen Freigabeverknüpfung zu verknüpfen, in einem dedizierten Abschnitt "Unterhaltung" des Shades angezeigt werden und konfigurationsoptionen anzeigen, die für Unterhaltungen eindeutig sind. Dieses Verhalten sollte für Personenunterhaltungen reserviert werden, bei denen es wahrscheinlich eine soziale Verpflichtung gibt, auf eine Person zu reagieren. Im Folgenden finden Sie beispielsweise einige Beispiele für Benachrichtigungen, die zum Unterhaltungsbereich gehören: 1:1-Unterhaltungen zwischen zwei Personen Gruppenunterhaltungen zwischen Einzelpersonen, bei denen jeder mitwirken kann. Im Folgenden finden Sie einige Beispiele für Benachrichtigungen, die nicht zum Unterhaltungsbereich gehören: Ankündigungen von einem Bot (auch wenn persönlich und kontextualisiert) Engagement-Benachrichtigungen von einem Bot Richtungsunterhaltungen, bei denen es einen aktiven Sprecher und viele passive Einzelpersonen gibt Streamen / Veröffentlichen von Updates von anderen Personen E-Mail, Dokumentkommentare oder andere Unterhaltungstypen, die nicht in Echtzeit sind

Darüber hinaus kann diese Methode für alle Arten von Benachrichtigungen verwendet werden, um diese Benachrichtigung als dupliziert eine Startprogrammverknüpfung zu kennzeichnen. Startprogramme, die Signale oder Benachrichtigungsinhalte anzeigen, können dann die Verknüpfung zugunsten des Inhalts dieser Benachrichtigung unterdrücken. Wenn diese Benachrichtigung BubbleMetadata angefügt hat, die mit einer shortcutId erstellt wurde, wird eine Überprüfung ausgeführt, um sicherzustellen, dass die für Blasenmetadaten bereitgestellte ShortcutId mit der hier festgelegten ShortcutId übereinstimmt, wenn eine festgelegt wurde. Wenn die ShortcutId angegeben, aber nicht übereinstimmen, wird eine Ausnahme ausgelöst.

Siehe auch:

Android-Referenz für android.app.Notification.Builder.setShortcutId.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: