ChatMessageNotificationTriggerDetails Klasse

Definition

Namespace:

Windows.ApplicationModel.Chat

Stellt die Nachrichtenbenachrichtigung dar, die von einer registrierten Hintergrundaufgabe ausgelöst wird. Eine Chat-App kann Benachrichtigungen über eingehende Nachrichten empfangen oder Ereignisse senden, indem sie einen Tasktrigger und einen Aufgabeneinstiegspunkt festlegt.

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

Vererbung

Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	chat chatSystem smsSend

Hinweise

Eine Chat-App muss eine Hintergrundaufgabe registrieren, um Benachrichtigungen zu verarbeiten, um als Standardhandler für eingehende Nachrichten zu dienen. Um eine Hintergrundaufgabe zu registrieren, muss die Datei Package.appxmanifest eine Hintergrundaufgabenerweiterung enthalten. Fügen Sie dem -Element den Application/Extensions folgenden Codeausschnitt hinzu.

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

Die Run-Methode der Hintergrundaufgabe empfängt eine Aufgabe instance mit den Details des Benachrichtigungstriggers. Die TriggerDetails-Eigenschaft wird in ein ChatMessageNotificationTriggerDetails-Objekt umgewandelt. Die Triggerdetails für eine Chatnachricht werden abgerufen, wie im folgenden Beispiel gezeigt.

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

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

Eigenschaften

ChatMessage	Ruft die der Benachrichtigung zugeordnete Nachricht ab. Dies ist entweder eine eingehende Nachricht oder eine ausgehende Nachricht mit einem Send status-Ereignis.
ShouldDisplayToast	Ruft einen booleschen Wert ab, der angibt, ob die Hintergrundaufgabe eine Popupbenachrichtigung für die Nachricht ausgeben soll.
ShouldUpdateActionCenter	Ruft einen booleschen Wert ab, der angibt, ob das Windows-Info-Center mit der Meldung aktualisiert werden soll.
ShouldUpdateBadge	Ruft einen booleschen Wert ab, der angibt, ob die Hintergrundaufgabe die Anzahl des Sperrbildschirms der App aktualisieren soll.
ShouldUpdateDetailText	Ruft einen booleschen Wert ab, der angibt, dass die Hintergrundaufgabe die Kachelanzahl der App für die Nachricht aktualisieren soll.