ChatMessageNotificationTriggerDetails Classe

Definição

Namespace:

Windows.ApplicationModel.Chat

Representa a notificação de mensagem disparada de uma tarefa em segundo plano registrada. Um aplicativo de chat pode receber notificações de mensagens de entrada ou enviar eventos definindo um gatilho de tarefa e um ponto de entrada de tarefa.

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

Herança

Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	chat chatSystem smsSend

Comentários

Um aplicativo de chat deve registrar uma tarefa em segundo plano para processar notificações para servir como o manipulador padrão para mensagens de entrada. Para registrar uma tarefa em segundo plano, o arquivo Package.appxmanifest deve conter uma extensão de tarefa em segundo plano. Adicione o snippet de código a seguir ao Application/Extensions elemento .

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

O método Run da tarefa em segundo plano recebe uma instância de tarefa com os detalhes do gatilho de notificação. A propriedade TriggerDetails é convertida em um objeto ChatMessageNotificationTriggerDetails. Os detalhes do gatilho de uma mensagem de chat são obtidos conforme mostrado no exemplo a seguir.

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

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

Propriedades

ChatMessage	Obtém a mensagem associada à notificação. Essa é uma mensagem de entrada ou uma mensagem de saída com um evento de envio status.
ShouldDisplayToast	Obtém um valor booliano que indica se a tarefa em segundo plano deve emitir uma notificação do sistema para a mensagem.
ShouldUpdateActionCenter	Obtém um valor booliano que indica se a Central de Ações do Windows deve ser atualizada com a mensagem.
ShouldUpdateBadge	Obtém um valor booliano que indica se a tarefa em segundo plano deve atualizar a contagem de tela de bloqueio do aplicativo.
ShouldUpdateDetailText	Obtém um valor booliano que indica que a tarefa em segundo plano deve atualizar a contagem de blocos do aplicativo para a mensagem.