Condividi tramite


ChatMessageNotificationTriggerDetails Classe

Definizione

Rappresenta la notifica del messaggio attivata da un'attività in background registrata. Un'app chat può ricevere notifiche di messaggi in ingresso o inviare eventi impostando un trigger attività e un punto di ingresso attività.

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
Ereditarietà
Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app
chat chatSystem smsSend

Commenti

Un'app chat deve registrare un'attività in background per elaborare le notifiche per servire come gestore predefinito per i messaggi in ingresso. Per registrare un'attività in background, il file Package.appxmanifest deve contenere un'estensione dell'attività in background. Aggiungere il frammento di codice seguente all'elemento Application/Extensions .

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

Il metodo Run dell'attività in background riceve un'istanza dell'attività con i dettagli del trigger di notifica. La proprietà TriggerDetails viene eseguita come cast in un oggetto ChatMessageNotificationTriggerDetails. I dettagli del trigger per un messaggio di chat vengono ottenuti come illustrato nell'esempio seguente.

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

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

Proprietà

ChatMessage

Ottiene il messaggio associato alla notifica. Si tratta di un messaggio in ingresso o di un messaggio in uscita con un evento di stato di invio.

ShouldDisplayToast

Ottiene un valore booleano che indica se l'attività in background deve inviare una notifica di tipo avviso popup per il messaggio.

ShouldUpdateActionCenter

Ottiene un valore booleano che indica se il Centro azioni di Windows deve essere aggiornato con il messaggio.

ShouldUpdateBadge

Ottiene un valore booleano che indica se l'attività in background deve aggiornare il conteggio dello schermo di blocco dell'app.

ShouldUpdateDetailText

Ottiene un valore booleano che indica che l'attività in background deve aggiornare il conteggio dei riquadri dell'app per il messaggio.

Si applica a