Notification.Builder.SetShortcutId(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
À partir d’Android 11, les notifications de messagerie (celles qui utilisent MessagingStyle) qui utilisent cette méthode pour lier à un raccourci de partage de longue durée publié peuvent apparaître dans une section conversation dédiée de l’ombre et peuvent afficher des options de configuration uniques aux conversations.
[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
Paramètres
- shortcutId
- String
Chaîne : l’ID du raccourci lié à cette notification
Retours
Cette instance Android.App.Notification.Builder, autorisant les appels à être chaînés.
- Attributs
Remarques
À partir d’Android 11, les notifications de messagerie (celles qui utilisent MessagingStyle) qui utilisent cette méthode pour lier à un raccourci de partage de longue durée publié peuvent apparaître dans une section conversation dédiée de l’ombre et peuvent afficher des options de configuration uniques aux conversations. Ce comportement doit être réservé aux conversations de personne à des personnes où il y a probablement une obligation sociale pour un individu de répondre. Par exemple, voici quelques exemples de notifications qui appartiennent à l’espace de conversation : 1:1 conversations entre deux individus Grouper des conversations entre individus où tout le monde peut contribuer Et voici quelques exemples de notifications qui n’appartiennent pas à l’espace de conversation : Annonces d’un bot (même si personnelles et contextuelles) Notifications Engagement d’une conversation directionnelle bot où il y a un orateur actif et de nombreux individus passifs Diffuser /publier des mises à jour à partir d’autres personnes e-mail, commentaires de document ou autres types de conversation qui ne sont pas en temps réel
En outre, cette méthode peut être utilisée pour tous les types de notifications pour marquer cette notification comme duplicative d’un raccourci lanceur. Les lanceurs qui affichent des badges ou du contenu de notification peuvent ensuite supprimer le raccourci en faveur du contenu de cette notification. Si cette notification comporte BubbleMetadata attaché qui a été créé avec un shortcutId, une vérification est effectuée pour vous assurer que l’id de raccourci fourni aux métadonnées de bulles correspond à l’id de raccourci défini ici, si l’un d’eux a été défini. Si les raccourcisId ont été spécifiés mais ne correspondent pas, une exception est levée.
Voir aussi :
Référence Android pour android.app.Notification.Builder.setShortcutId.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.