ChatMessageNotificationTriggerDetails 类

定义

命名空间:

Windows.ApplicationModel.Chat

表示从已注册的后台任务触发的消息通知。 聊天应用可以通过设置任务触发器和任务入口点来接收传入消息或发送事件的通知。

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

继承

Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能	chat chatSystem smsSend

注解

聊天应用必须注册后台任务才能处理通知，才能充当传入消息的默认处理程序。 为了注册后台任务， Package.appxmanifest 文件必须包含后台任务扩展。 将以下代码片段添加到 元素中 Application/Extensions 。

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

后台任务的 Run 方法接收包含通知触发器详细信息的任务实例。 TriggerDetails 属性强制转换为 ChatMessageNotificationTriggerDetails 对象。 获取聊天消息的触发器详细信息，如以下示例所示。

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

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

属性

ChatMessage	获取与通知关联的消息。 这是传入消息或具有发送状态事件的传出消息。
ShouldDisplayToast	获取一个布尔值，该值指示后台任务是否应为消息发出 Toast 通知。
ShouldUpdateActionCenter	获取一个布尔值，该值指示是否应使用 消息更新 Windows 操作中心。
ShouldUpdateBadge	获取一个布尔值，该值指示后台任务是否应更新应用的锁屏计数。
ShouldUpdateDetailText	获取一个布尔值，该值指示后台任务应更新应用的消息磁贴计数。