Compartilhar via

ChatMessageNotificationTriggerDetails Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.Chat
Editar

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.

Aplica-se a