ChatMessageNotificationTriggerDetails Classe

Référence

Définition

Espace de noms:: Windows.ApplicationModel.Chat

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.

Modifier

Représente la notification de message déclenchée à partir d’une tâche en arrière-plan inscrite. Une application de conversation peut recevoir des notifications de messages entrants ou envoyer des événements en définissant un déclencheur de tâche et un point d’entrée de tâche.

public ref class ChatMessageNotificationTriggerDetails sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ChatMessageNotificationTriggerDetails final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ChatMessageNotificationTriggerDetails

Public NotInheritable Class ChatMessageNotificationTriggerDetails

Héritage: Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	chat chatSystem smsSend

Remarques

Une application de conversation doit inscrire une tâche en arrière-plan pour traiter les notifications afin de servir de gestionnaire par défaut pour les messages entrants. Pour inscrire une tâche en arrière-plan, le fichier Package.appxmanifest doit contenir une extension de tâche en arrière-plan. Ajoutez l’extrait de code suivant à l’élément Application/Extensions .

<Extension Category="windows.backgroundTasks" Entry-Point="Tasks.ExampleBackgroundTask">
    <BackgroundTasks>
        <Task Type="chatMessageNotification"/>
        <Task Type="systemEvent"/>
    </BackgroundTasks>
</Extension>

La méthode Run de la tâche en arrière-plan reçoit une tâche instance avec les détails du déclencheur de notification. La propriété TriggerDetails est castée en objet ChatMessageNotificationTriggerDetails. Les détails du déclencheur d’un message de conversation sont obtenus comme indiqué dans l’exemple suivant.

public void Run(IBackgroundTaskInstance taskInstance)
{
    BackgroundTaskDeferral deferral = taskInstance.GetDeferral();
    ChatMessageNotificationTriggerDetails triggerDetails =
        (ChatMessageNotificationTriggerDetails) taskInstance.TriggerDetails;

    if (triggerDetails != null)
    {
        SendToast(triggerDetails.ChatMessage);
    }
}

Propriétés

ChatMessage	Obtient le message associé à la notification. Il s’agit d’un message entrant ou d’un message sortant avec un événement d’envoi status.
ShouldDisplayToast	Obtient une valeur booléenne indiquant si la tâche en arrière-plan doit émettre une notification toast pour le message.
ShouldUpdateActionCenter	Obtient une valeur booléenne indiquant si le Centre de notifications Windows doit être mis à jour avec le message.
ShouldUpdateBadge	Obtient une valeur booléenne indiquant si la tâche en arrière-plan doit mettre à jour le nombre d’écrans de verrouillage de l’application.
ShouldUpdateDetailText	Obtient une valeur booléenne indiquant que la tâche en arrière-plan doit mettre à jour le nombre de vignettes de l’application pour le message.

S’applique à

Partager via