AppNotificationBuilder.SetAudioEvent Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Overload

SetAudioEvent(AppNotificationSoundEvent)	Imposta l'evento audio per una notifica dell'app.
SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)	Imposta l'evento audio e il comportamento di ciclo per una notifica dell'app.

SetAudioEvent(AppNotificationSoundEvent)

Imposta l'evento audio per una notifica dell'app.

public:
 virtual AppNotificationBuilder ^ SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent) = SetAudioEvent;

/// [Windows.Foundation.Metadata.Overload("SetAudioEvent")]
AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent const& appNotificationSoundEvent);

[Windows.Foundation.Metadata.Overload("SetAudioEvent")]
public AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent);

function setAudioEvent(appNotificationSoundEvent)

Public Function SetAudioEvent (appNotificationSoundEvent As AppNotificationSoundEvent) As AppNotificationBuilder

Parametri

appNotificationSoundEvent

AppNotificationSoundEvent

Membro dell'enumerazione appNotificationSoundEvent che specifica un suono di sistema da riprodurre.

Restituisce

AppNotificationBuilder

Restituisce il 'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Attributi

OverloadAttribute

Esempio

L'esempio seguente illustra l'impostazione di un evento audio nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm'/>
</toast>

Commenti

Questo metodo consente di offrire un'esperienza audio coerente specificando un tipo di evento audio, che usa suoni di sistema standardizzati. È possibile specificare un suono personalizzato per una notifica dell'app chiamando SetAudioUri.

Per indicazioni sull'uso delle API di AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere contenuto di notifica dell'app.

Per informazioni di riferimento su XML Schema per le notifiche delle app, vedere Schema del contenuto di notifica dell'app.

SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)

Imposta l'evento audio e il comportamento di ciclo per una notifica dell'app.

public:
 virtual AppNotificationBuilder ^ SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent, AppNotificationAudioLooping loop) = SetAudioEvent;

/// [Windows.Foundation.Metadata.Overload("SetAudioEvent2")]
AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent const& appNotificationSoundEvent, AppNotificationAudioLooping const& loop);

[Windows.Foundation.Metadata.Overload("SetAudioEvent2")]
public AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent, AppNotificationAudioLooping loop);

function setAudioEvent(appNotificationSoundEvent, loop)

Public Function SetAudioEvent (appNotificationSoundEvent As AppNotificationSoundEvent, loop As AppNotificationAudioLooping) As AppNotificationBuilder

Parametri

appNotificationSoundEvent

AppNotificationSoundEvent

Membro dell'enumerazione appNotificationSoundEvent che specifica un suono di sistema da riprodurre.

loop

AppNotificationAudioLooping

Membro dell'enumerazione AppNotificationAudioLooping che specifica il comportamento di ciclo per l'audio.

Restituisce

AppNotificationBuilder

Restituisce il 'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Attributi

OverloadAttribute

Esempio

L'esempio seguente illustra l'impostazione di un evento audio nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm' loop='true'/>
</toast>

Commenti

Questo metodo consente di offrire un'esperienza audio coerente specificando un tipo di evento audio, che usa suoni di sistema standardizzati. È possibile specificare un suono personalizzato per una notifica dell'app chiamando SetAudioUri.

Per indicazioni sull'uso delle API di AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere contenuto di notifica dell'app.

Per informazioni di riferimento su XML Schema per le notifiche delle app, vedere Schema del contenuto di notifica dell'app.