AppNotificationBuilder.SetAudioUri メソッド

定義

名前空間:

Microsoft.Windows.AppNotifications.Builder

オーバーロード

SetAudioUri(Uri)	アプリ通知が表示されたときに再生されるサウンド ファイルを設定します。
SetAudioUri(Uri, AppNotificationAudioLooping)	アプリ通知が表示されたときに再生されるサウンド ファイルとオーディオ ループ動作を設定します。

SetAudioUri(Uri)

アプリ通知が表示されたときに再生されるサウンド ファイルを設定します。

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

パラメーター

audioUri

Uri Uri

オーディオ ファイルの URI。

戻り値

AppNotificationBuilder

追加のメソッド呼び出しをチェーンできるように、AppNotificationBuilder インスタンスを返します。

属性

OverloadAttribute

例

次の例では、アプリ通知の XML ペイロードにオーディオ URI を設定する方法を示します。

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


AppNotificationManager.Default.Show(notification);

結果の XML ペイロード:

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

注釈

次のオーディオ ファイルの種類がサポートされています。

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

次のオーディオ ファイル ソースがサポートされています。

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

次のオーディオ ファイル ソースはサポートされていません。

• ms-appdata
• http://、https:// などのインターネット URL
• 絶対ファイル パス (C:/、F:/など)。

SetAudioEventを呼び出すことによって、システム定義のサウンドを再生するサウンド イベント 指定できます。

AppNotificationBuilder API を使用してアプリ通知用の UI を作成する方法については、「アプリ通知コンテンツ参照してください。

アプリ通知の XML スキーマのリファレンス情報については、「アプリ通知コンテンツ スキーマ」を参照してください。

SetAudioUri(Uri, AppNotificationAudioLooping)

アプリ通知が表示されたときに再生されるサウンド ファイルとオーディオ ループ動作を設定します。

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

パラメーター

audioUri

Uri Uri

オーディオ ファイルの URI。

loop

AppNotificationAudioLooping

オーディオのループ動作を指定する AppNotificationAudioLooping 列挙体のメンバー。

戻り値

AppNotificationBuilder

追加のメソッド呼び出しをチェーンできるように、AppNotificationBuilder インスタンスを返します。

属性

OverloadAttribute

例

次の例では、アプリ通知の XML ペイロードにオーディオ URI を設定する方法を示します。

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


AppNotificationManager.Default.Show(notification);

結果の XML ペイロード:

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

注釈

次のオーディオ ファイルの種類がサポートされています。

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

次のオーディオ ファイル ソースがサポートされています。

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

次のオーディオ ファイル ソースはサポートされていません。

• ms-appdata
• http://、https:// などのインターネット URL
• 絶対ファイル パス (C:/、F:/など)。

SetAudioEventを呼び出すことによって、システム定義のサウンドを再生するサウンド イベント 指定できます。

AppNotificationBuilder API を使用してアプリ通知用の UI を作成する方法については、「アプリ通知コンテンツ参照してください。

アプリ通知の XML スキーマのリファレンス情報については、「アプリ通知コンテンツ スキーマ」を参照してください。