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	取得布林值，指出背景工作是否應該發出訊息的快顯通知。
ShouldUpdateActionCenter	取得布林值，指出是否應該使用訊息更新 Windows 控制中心。
ShouldUpdateBadge	取得布林值，指出背景工作是否應該更新應用程式的鎖定畫面計數。
ShouldUpdateDetailText	取得布林值，指出背景工作應該更新訊息的磚計數。