AppNotificationBuilder.SetAudioUri Metodo

Definizione

Spazio dei nomi:

Microsoft.Windows.AppNotifications.Builder

Overload

SetAudioUri(Uri)	Imposta il file audio riprodotto quando viene visualizzata una notifica dell'app.
SetAudioUri(Uri, AppNotificationAudioLooping)	Imposta il file audio e il comportamento di ciclo audio riprodotto quando viene visualizzata una notifica dell'app.

SetAudioUri(Uri)

Imposta il file audio riprodotto quando viene visualizzata una notifica dell'app.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri) = SetAudioUri;

/// [Windows.Foundation.Metadata.Overload("SetAudioUri")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri);

[Windows.Foundation.Metadata.Overload("SetAudioUri")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri);

function setAudioUri(audioUri)

Public Function SetAudioUri (audioUri As Uri) As AppNotificationBuilder

Parametri

audioUri

Uri Uri

URI del file 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 URI audio nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"))
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

Commenti

Sono supportati i tipi di file audio seguenti:

• .aac
• .flac
• .m4a
• .mp3
• .wav
• .wma

Sono supportate le origini file audio seguenti:

• ms-appx:///
• ms-resource

Le origini file audio seguenti non sono supportate:

• ms-appdata
• URL Internet, ad esempio http://, https://
• Percorsi di file assoluti, ad esempio C:/, F:/e così via.

È possibile specificare un evento audio, che riproduce un suono definito dal sistema, chiamando SetAudioEvent.

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.

SetAudioUri(Uri, AppNotificationAudioLooping)

Imposta il file audio e il comportamento di ciclo audio riprodotto quando viene visualizzata una notifica dell'app.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri, AppNotificationAudioLooping loop) = SetAudioUri;

/// [Windows.Foundation.Metadata.Overload("SetAudioUri2")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri, AppNotificationAudioLooping const& loop);

[Windows.Foundation.Metadata.Overload("SetAudioUri2")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri, AppNotificationAudioLooping loop);

function setAudioUri(audioUri, loop)

Public Function SetAudioUri (audioUri As Uri, loop As AppNotificationAudioLooping) As AppNotificationBuilder

Parametri

audioUri

Uri Uri

URI del file audio.

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 URI audio nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"), AppNotificationAudioLooping.Loop)
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

Commenti

Sono supportati i tipi di file audio seguenti:

• .aac
• .flac
• .m4a
• .mp3
• .wav
• .wma

Sono supportate le origini file audio seguenti:

• ms-appx:///
• ms-resource

Le origini file audio seguenti non sono supportate:

• ms-appdata
• URL Internet, ad esempio http://, https://
• Percorsi di file assoluti, ad esempio C:/, F:/e così via.

È possibile specificare un evento audio, che riproduce un suono definito dal sistema, chiamando SetAudioEvent.

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.