Share via


クイック スタート: アプリへのオーディオの追加 (HTML)

[ この記事は、Windows ランタイム アプリを作成する Windows 8.x および Windows Phone 8.x 開発者を対象としています。Windows 10 向けの開発を行っている場合は、「最新のドキュメント」をご覧ください]

このトピックでは、オーディオ ストリーミング カテゴリについて説明すると共に、<audio> タグを使ってアプリにオーディオ ストリーミング機能を追加する方法を示します。

Windows 8 では、HTML5 を使って比較的簡単に Windows ストア アプリにオーディオ ストリーミング機能を追加できるプラットフォームが提供されています。

audio タグには次の属性があります。

属性 指定可能な値 説明
autoplay autoplay 準備が完了したらすぐにオーディオの再生を開始するよう指定
controls controls オーディオ コントロール (再生ボタン、一時停止ボタンなど) を表示するよう指定
loop loop オーディオの再生が終わるたびにまた最初から再生を開始するよう指定
preload

auto

metadata

none

ページを読み込むときにオーディオも読み込むかどうか、およびその方法を指定
src <ファイル パス> オーディオ ファイルへのパスを指定

 

Microsoft では、msAudioCategory という追加の属性も提供しています。この属性を使うと、オーディオ認識アプリの動作を拡張できます。次の表は、この属性に指定できる値と、実行内容の簡単な説明を示しています。

ストリームのカテゴリ 説明 バックグラウンド動作
Alert ループまたは長時間再生されるアラート サウンド。
  • アラーム
  • 着信音
  • 呼び出し通知
  • オーディオの現在の音量を下げる必要のあるサウンド
不可
BackgroundCapableMedia バックグラウンドで再生を続ける必要のあるオーディオ用。 次のローカル メディア再生シナリオなどの例があります。
  • ローカルの再生リスト
  • ラジオのストリーミング
  • 再生リストのストリーミング
  • 音楽ビデオ
  • オーディオ/ラジオのストリーミング、YouTube、Netflix など
Communications 次のような通信オーディオのストリーミング用。
  • VOIP
  • リアルタイム チャットまたは別の音声通話
ForeGroundOnlyMedia フォアグラウンドでのみ動作するように設計されたゲームまたはその他のサウンド。ただし、既にあるバックグラウンド メディア サウンドはミュートされます。
  • ゲーム エクスペリエンスに必要なゲーム オーディオ (ダンス ゲーム、音楽ゲーム)
  • 長編映画 (バックグラウンドになった場合は一時停止するように設計されている)
不可
GameEffects 既にあるオーディオと組み合わせるよう設計されたゲームのサウンド効果
  • キャラクターの会話
  • 音楽以外のすべてのサウンド
不可
GameMedia ゲームで再生されるバックグラウンド ミュージック 不可
SoundEffects 既にあるオーディオと組み合わせるよう設計されたゲームまたはその他のサウンド効果
  • キャラクターの会話
  • ビープ音、ベル、簡単なサウンド
不可
Other 既定のオーディオの種類で、バックグラウンドで再生を続ける必要のない、すべてのオーディオ メディアに推奨 不可

 

目標: 最も簡単にオーディオ機能を Windows ストア アプリに追加するには

必要条件

HTML、JavaScript、Windows イベント、イベント処理について理解している必要があります。

MPEG-Layer 3 (MP3) やその他のデジタル音楽ファイルを再生できるメディア プレーヤーがインストールされている必要があります。

完了までの時間: 15 分.

手順

<audio> タグを使ってオーディオを追加する

<audio> タグを追加する場合、"controls" 属性を使って、コントロール (ボタン) を表示することを示す必要があります。この処理を実行する手順を次に示します。

  • 次のコードをコピーして、HTML ファイル内のオーディオ コントロールを表示する場所に貼り付けます。

    // Adding the <audio> tag to your app
    <audio controls="controls"> 
    <source src="song.mp3"/> 
    </audio>
    

msAudioCategory 属性を追加する

msAudioCategory 属性を <audio> タグに追加すると、機能が増えます。 msAudioCategory 属性は特定の拡張動作と audio タグを関連付け、それによりアプリのユーザー エクスペリエンスが向上します。msAudioCategory 属性を追加する手順を次に示します。

  • 次のように、msAudioCategory 属性を <audio> タグ内に追加します。

    // Enhancing behavior of audio tag
    // with the msAudioCategory attribute
    <audio msAudioCategory="BackgroundCapableMedia" controls="controls"> 
    <source src="song.mp3"/> 
    </audio>
    

要約と次のステップ

カテゴリによってアプリの動作が異なるため、ストリーム用に選択するカテゴリは慎重に検討することが重要です。

次のトピック「メディア コントロール キーの構成方法」では、メディア ボタンを Windows ストア アプリに追加して構成する方法について説明します。ボタンを構成すると、そのボタンを使ってオーディオ ストリームを再生、一時停止、停止、または早送りすることができます。

関連トピック

メディア コントロール キーの構成方法

メディア キーの構成サンプル

再生マネージャーのサンプル