Language

AppNotificationBuilder.SetAudioUri メソッド

定義

オーバーロード

名前 説明
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 インスタンスを返します。

属性

例

次の例では、アプリ通知の 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 インスタンスを返します。

属性

例

次の例では、アプリ通知の 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 スキーマのリファレンス情報については、「アプリ通知コンテンツ スキーマ」を参照してください。

適用対象