Freigeben über

AppNotificationBuilder.SetAudioUri Methode

  • Referenz

Definition

Namespace:
Microsoft.Windows.AppNotifications.Builder

Überlädt

SetAudioUri(Uri)

Legt die Sounddatei fest, die wiedergegeben wird, wenn eine App-Benachrichtigung angezeigt wird.
SetAudioUri(Uri, AppNotificationAudioLooping)

Legt die Sounddatei und das Audioschleifenverhalten fest, das wiedergegeben wird, wenn eine App-Benachrichtigung angezeigt wird.

SetAudioUri(Uri)

Bearbeiten

Legt die Sounddatei fest, die wiedergegeben wird, wenn eine App-Benachrichtigung angezeigt wird.

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

Parameter

audioUri
Uri Uri

Der URI der Audiodatei.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute
OverloadAttribute

Beispiele

Im folgenden Beispiel wird das Festlegen eines Audio-URI in der XML-Nutzlast für eine App-Benachrichtigung veranschaulicht.

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


AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

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

Hinweise

Die folgenden Audiodateitypen werden unterstützt:

  • AAC
  • .flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Die folgenden Audiodateiquellen werden unterstützt:

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

Die folgenden Audiodateiquellen werden nicht unterstützt:

  • ms-appdata
  • Internet-URLs, z. B. http://, https://
  • Absolute Dateipfade, z. B. C:/, F:/usw.

Sie können ein Soundereignis angeben, das einen vom System definierten Sound wiedergibt, indem Sie SetAudioEvent-aufrufen.

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.

Gilt für:

SetAudioUri(Uri, AppNotificationAudioLooping)

Bearbeiten

Legt die Sounddatei und das Audioschleifenverhalten fest, das wiedergegeben wird, wenn eine App-Benachrichtigung angezeigt wird.

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

Parameter

audioUri
Uri Uri

Der URI der Audiodatei.

loop
AppNotificationAudioLooping

Ein Element der AppNotificationAudioLooping Enumeration, die das Schleifenverhalten für das Audio angibt.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute
OverloadAttribute

Beispiele

Im folgenden Beispiel wird das Festlegen eines Audio-URI in der XML-Nutzlast für eine App-Benachrichtigung veranschaulicht.

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


AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

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

Hinweise

Die folgenden Audiodateitypen werden unterstützt:

  • AAC
  • .flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Die folgenden Audiodateiquellen werden unterstützt:

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

Die folgenden Audiodateiquellen werden nicht unterstützt:

  • ms-appdata
  • Internet-URLs, z. B. http://, https://
  • Absolute Dateipfade, z. B. C:/, F:/usw.

Sie können ein Soundereignis angeben, das einen vom System definierten Sound wiedergibt, indem Sie SetAudioEvent-aufrufen.

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.

Gilt für: