ChatMessageNotificationTriggerDetails Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Chat

Representa la notificación de mensaje desencadenada desde una tarea en segundo plano registrada. Una aplicación de chat puede recibir notificaciones de mensajes entrantes o enviar eventos estableciendo un desencadenador de tarea y un punto de entrada de tarea.

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

Herencia

Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	chat chatSystem smsSend

Comentarios

Una aplicación de chat debe registrar una tarea en segundo plano para procesar las notificaciones con el fin de servir como controlador predeterminado para los mensajes entrantes. Para registrar una tarea en segundo plano, el archivo Package.appxmanifest debe contener una extensión de tarea en segundo plano. Agregue el siguiente fragmento de código al Application/Extensions elemento .

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

El método Run de la tarea en segundo plano recibe una instancia de tarea con los detalles del desencadenador de notificación. La propiedad TriggerDetails se convierte en un objeto ChatMessageNotificationTriggerDetails. Los detalles del desencadenador de un mensaje de chat se obtienen como se muestra en el ejemplo siguiente.

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

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

Propiedades

ChatMessage	Obtiene el mensaje asociado a la notificación. Se trata de un mensaje entrante o un mensaje saliente con un evento de estado de envío.
ShouldDisplayToast	Obtiene un valor booleano que indica si la tarea en segundo plano debe emitir una notificación del sistema para el mensaje.
ShouldUpdateActionCenter	Obtiene un valor booleano que indica si el Centro de actividades de Windows debe actualizarse con el mensaje.
ShouldUpdateBadge	Obtiene un valor booleano que indica si la tarea en segundo plano debe actualizar el recuento de pantalla de bloqueo de la aplicación.
ShouldUpdateDetailText	Obtiene un valor booleano que indica que la tarea en segundo plano debe actualizar el recuento de iconos de la aplicación para el mensaje.