AppNotificationBuilder.SetAudioUri Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

SetAudioUri(Uri)	Define o arquivo de som que é reproduzido quando uma notificação de aplicativo é exibida.
SetAudioUri(Uri, AppNotificationAudioLooping)	Define o arquivo de som e o comportamento de looping de áudio que é reproduzido quando uma notificação de aplicativo é exibida.

SetAudioUri(Uri)

Define o arquivo de som que é reproduzido quando uma notificação de aplicativo é exibida.

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

Parâmetros

audioUri

Uri Uri

O URI do arquivo de áudio.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra a configuração de um URI de áudio no conteúdo XML para uma notificação de aplicativo.

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


AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

Há suporte para os seguintes tipos de arquivo de áudio:

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

Há suporte para as seguintes fontes de arquivo de áudio:

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

As seguintes fontes de arquivo de áudio não têm suporte:

• ms-appdata
• URLs da Internet, como http://, https://
• Caminhos de arquivo absolutos, como C:/, F:/, etc.

Você pode especificar um evento de som, que reproduz um som definido pelo sistema, chamando SetAudioEvent.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.

SetAudioUri(Uri, AppNotificationAudioLooping)

Define o arquivo de som e o comportamento de looping de áudio que é reproduzido quando uma notificação de aplicativo é exibida.

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

Parâmetros

audioUri

Uri Uri

O URI do arquivo de áudio.

loop

AppNotificationAudioLooping

Um membro da enumeração AppNotificationAudioLooping especificando o comportamento de looping para o áudio.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra a configuração de um URI de áudio no conteúdo XML para uma notificação de aplicativo.

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


AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

Há suporte para os seguintes tipos de arquivo de áudio:

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

Há suporte para as seguintes fontes de arquivo de áudio:

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

As seguintes fontes de arquivo de áudio não têm suporte:

• ms-appdata
• URLs da Internet, como http://, https://
• Caminhos de arquivo absolutos, como C:/, F:/, etc.

Você pode especificar um evento de som, que reproduz um som definido pelo sistema, chamando SetAudioEvent.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.