ChatMessageNotificationTriggerDetails Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.ApplicationModel.Chat

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Condividi tramite