AppNotificationBuilder.SetAudioUri Methode

Definition

Namespace:: Microsoft.Windows.AppNotifications.Builder

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
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)