オーディオセッション

1. はじめに

人々は、ますます Web を通じてメディア（オーディオ/ビデオ）を消費するようになっており、 Web はこの種のコンテンツにアクセスするための主要なチャネルになっています。しかし、Web 上のメディアは、多くの場合、基盤となるプラットフォームとのシームレスな統合を欠いています。 Audio Session API は、オーディオセッション管理または類似のオーディオフォーカス機能をサポートするプラットフォーム全体でメディア処理を強化することにより、この隔たりに対処します。この API は、Web ベースのオーディオが他のアプリとどのように相互作用するかを改善し、コンテキストに応じて、より良いオーディオミキシングまたは排他的な再生を可能にし、デバイス全体でより一貫した統合メディア体験を提供します。

さらに、一部のプラットフォームは、メディア再生およびオーディオ再生に使用される API に基づいて、サイトのオーディオセッションを自動的に管理します。しかし、この振る舞いは、常にユーザーの期待に沿うとは限りません。この API により、開発者はデフォルトの振る舞いを上書きし、オーディオセッションをより細かく制御できます。

2. 概念

Web ページは、HTMLMediaElement や AudioContext などのさまざまな API を組み合わせて、さまざまな方法でオーディオ処理を行うことができます。このオーディオ処理には開始と停止があり、使用されているすべての異なるオーディオ API を集約します。オーディオセッションは、この集約されたオーディオ処理を表します。これは、Web ページが行うオーディオ処理の一般的な性質を Web ページが表明できるようにします。

オーディオセッションは、特定の型を持ち、特定の状態にあることができます。オーディオセッションは、個々のソース（マイク録音）およびシンク（オーディオレンダリング）の集合に対するオーディオを管理し、それらはオーディオセッションの要素と呼ばれます。

オーディオセッションの要素には、いくつかのプロパティがあります。

デフォルト型。これは、"auto" の場合に、オーディオセッションの型を計算するために使用されます。
可聴フラグ。これは、要素がオーディオを再生/録音している場合は true、そうでない場合は false です。

オーディオセッション要素は、その可聴フラグが true の場合、可聴要素です。

さらに、オーディオセッション要素には、さまざまな状態変化を処理するための関連する手順があります。デフォルトでは、これらの各手順は空の手順リストです。

要素更新手順。これは、オーディオセッション状態が変化するたびに実行されます。
要素一時停止手順。これは、オーディオセッション状態が active から interrupted または inactive のいずれかへ移行したときに実行されます。
要素再開手順。これは、オーディオセッション状態が interrupted から active へ移行したときに実行されます。

この仕様は、これらの手順、デフォルト型、および可聴フラグを、オーディオセッションの一部の要素について、§ 6 オーディオソースおよびシンクの統合で定義しています。他の要素を定義する仕様は、これらの手順とプロパティを定義する必要があります。

トップレベル閲覧コンテキストは、選択されたオーディオセッションを持ちます。任意のオーディオセッションに変更があった場合、ユーザーエージェントはどのオーディオセッションが選択されたオーディオセッションになるかを更新します。トップレベル閲覧コンテキストは、その選択されたオーディオセッションが null でなく、かつその状態が active である場合、オーディオフォーカスを持つといいます。

ユーザーエージェントは、複数のトップレベル閲覧コンテキストがオーディオフォーカスを持つことを許可するか、または任意の時点で単一のトップレベル閲覧コンテキストだけがオーディオフォーカスを持つように強制するかを決定できます。

3. `AudioSession` インターフェイス

AudioSession は、この API の主要なインターフェイスです。これは Navigator インターフェイスを通じてアクセスされます（§ 4 Navigator インターフェイスへの拡張を参照）。

[Exposed=Window]
interface AudioSession : EventTarget {
  attribute AudioSessionType type;

  readonly attribute AudioSessionState state;
  attribute EventHandler onstatechange;
};

realm に AudioSession オブジェクトを作成するには、次の手順を実行します。

audioSession を、realm における新しい AudioSession オブジェクトとし、次の内部スロットで初期化します。
1. [[type]] は、オーディオセッションの型を格納し、 auto に初期化されます。
2. [[state]] は、オーディオセッションの状態を格納し、inactive に初期化されます。
3. [[elements]] は、オーディオセッションの要素を格納し、空リストに初期化されます。
4. [[interruptedElements]] は、可聴である間に中断されたオーディオセッションの要素を格納し、空リストに初期化されます。
5. [[appliedType]] は、オーディオセッションに適用された型を格納し、 auto に初期化されます。
6. [[isTypeBeingApplied]] フラグは、型がオーディオセッションに適用中かどうかを格納し、 false に初期化されます。
audioSession を返します。

各 AudioSession オブジェクトは、その基盤となるオーディオセッションに一意に結び付けられます。

AudioSession の state 属性は、そのオーディオセッションの状態を反映します。取得時には、AudioSession の [[state]] 値を返さなければなりません。

AudioSession の type 属性は、auto を除き、そのオーディオセッションの型を反映します。

取得時には、AudioSession の [[type]] 値を返さなければなりません。

設定時には、audioSession に設定される新しい値を newValue として、次の手順を実行しなければなりません。

audioSession.[[type]] が newValue と等しい場合、これらの手順を中止します。
audioSession.[[type]] を newValue に設定します。
audioSession の型を更新します。

3.1. オーディオセッション型

慣例として、さまざまな目的に応じて、いくつかの異なるオーディオセッションの型があります。 API では、これらは AudioSessionType enum によって表されます。

playback: 再生オーディオ。これは動画や音楽再生、ポッドキャストなどに使用されます。他の再生オーディオとミックスされるべきではありません。（おそらく）他のすべてのオーディオを無期限に一時停止すべきです。
transient: 通知音などの一時的なオーディオ。通常、再生オーディオの上に重ねて再生されるべきです（また、永続的なオーディオを「ダック」することもあります）。
transient-solo: 運転案内などの一時的なソロオーディオ。他のすべてのオーディオを一時停止/ミュートし、排他的に再生すべきです。一時的なソロオーディオが終了したときは、一時停止/ミュートされたオーディオを再開すべきです。
ambient: アンビエントオーディオ。これは他の種類のオーディオとミックス可能です。ユーザーが複数のページからのオーディオをミックスしたい場合など、一部の特殊なケースで有用です。
play-and-record: 再生および録音オーディオ。これはオーディオ録音に使用されます。マイクが使用されている場合やビデオ会議アプリケーションで有用です。
auto: Auto は、Web ページによるオーディオの使用に応じて、ユーザーエージェントが最適なオーディオセッション型を選択できるようにします。これは AudioSession のデフォルト型です。

enum AudioSessionType {
  "auto",
  "playback",
  "transient",
  "transient-solo",
  "ambient",
  "play-and-record"
};

AudioSessionType は、それが playback、 play-and-record または transient-solo である場合、排他的型です。

3.2. オーディオセッション状態

オーディオセッションは、次のいずれかの状態にあることができ、これらは API では AudioSessionState enum によって表されます。

active: オーディオセッションは、音を再生しているか、マイクを録音しています。
interrupted: オーディオセッションは、音を再生しておらず、マイクも録音していませんが、中断が解除されれば再開できます。
inactive: オーディオセッションは、音を再生しておらず、マイクも録音していません。

enum AudioSessionState {
  "inactive",
  "active",
  "interrupted"
};

オーディオセッションの状態は変化する可能性があり、その変化は状態の変化を通知する手順を通じて、対応する AudioSession オブジェクトに自動的に反映されます。

4. `Navigator` インターフェイスへの拡張

各 Window は、関連付けられた AudioSessionを持ち、これは AudioSession オブジェクトです。これは、オーディオセッションパラメーターを自動的に設定するためにユーザーエージェントが使用するデフォルトのオーディオセッションを表します。ユーザーエージェントは、オーディオセッション要素が再生を開始または終了したときに、オーディオフォーカスを要求または放棄します。 Window オブジェクトの作成時に、その関連付けられた AudioSessionは、AudioSession オブジェクトとして新たに作成され、Window オブジェクトの関連するレルムで設定されなければなりません。

関連付けられた AudioSession の要素のリストは、Window オブジェクトのオーディオソースおよびシンクが作成または削除されるにつれて動的に更新されます。

[Exposed=Window]
partial interface Navigator {
  // The default audio session that the user agent will use when media elements start/stop playing.
  readonly attribute AudioSession audioSession;
};

5. オーディオセッションアルゴリズム

5.1. AudioSession の type を更新する

audioSession の型を更新するには、ユーザーエージェントは次の手順を実行しなければなりません。

audioSession.[[isTypeBeingApplied]] が true の場合、これらの手順を中止します。
audioSession.[[isTypeBeingApplied]] を true に設定します。
次の手順を実行するタスクをキューに入れます。
1. audioSession.[[isTypeBeingApplied]] を false に設定します。
2. audioSession.[[type]] が audioSession.[[appliedType]] と同じである場合、これらの手順を中止します。
3. audioSession.[[appliedType]] を audioSession.[[type]] に設定します。
4. audioSession により、audioSession のトップレベル閲覧コンテキストのすべての AudioSession 状態を更新します。
5. audioSession.[[elements]] の各 element について、element を更新します。
6. newType を、audioSession の型を計算する結果とします。
7. 並列に、audioSession のオーディオセッションの型を newType に設定します。

5.2. AudioSession の state を更新する

オーディオセッション要素が開始または停止しているとき、ユーザーエージェントは、非アクティブ化するおよびアクティブ化を試みるアルゴリズムを通じて、オーディオセッションの状態を設定する手順を実行します。オーディオセッションの状態を active に設定することには、特にオーディオセッションの型が排他的型である場合、結果が伴います。

以下のアルゴリズムで定義されるように、トップレベル閲覧コンテキストの AudioSession オブジェクトを非アクティブ化できます。
別のタブまたは別のアプリケーションのオーディオを一時停止できます。

逆に、オーディオセッションの状態は、オーディオセッション要素の変更とは別に変更されることがあります。ユーザーエージェントがそのような変更を観測したとき、ユーザーエージェントは、変更されたオーディオセッションに結び付けられた AudioSession オブジェクトである audioSession と、新しいオーディオセッション状態である newState を用いて、状態の変化を通知するためのタスクをキューに入れなければなりません。

アクティブな playback オーディオセッションは、着信電話、または別のタブで新しいメディアコンテンツの再生を開始しようとしている別の playback セッションによって中断されることがあります。

audioSession および newState を用いて状態の変化を通知するには、ユーザーエージェントは次の手順を実行しなければなりません。

isMutatingState を、audioSession.[[state]] が newState でない場合は true、そうでない場合は false とします。
audioSession.[[state]] を newState に設定します。
newState が inactive の場合、 audioSession.[[interruptedElements]] を空リストに設定します。
audioSession.[[elements]] の各 element について、element を更新します。
isMutatingState が false の場合、これらの手順を中止します。
audioSession により、audioSession のトップレベル閲覧コンテキストのすべての AudioSession 状態を更新します。
audioSession に対して statechange という名前のイベントを発火します。

audioSession という名前の AudioSession を非アクティブ化するには、ユーザーエージェントは次の手順を実行しなければなりません。

audioSession.[[state]] が inactive である場合、これらの手順を中止します。
次の手順を並列に実行します。
1. audioSession のオーディオセッションの状態を設定し、 inactive にします。
2. アサート: audioSession のオーディオセッションの状態は inactive です。
3. audioSession と、そのオーディオセッションの状態を用いて、状態の変化を通知するためのタスクをキューに入れます。

audioSession という名前の AudioSession のアクティブ化を試みるには、ユーザーエージェントは次の手順を実行しなければなりません。

audioSession.[[state]] が active である場合、これらの手順を中止します。
次の手順を並列に実行します。
1. audioSession のオーディオセッションの状態を設定し、 active にします。状態を設定することは、 active に対して失敗する可能性があり、その場合、オーディオセッションの状態は inactive または interrupted のいずれかになります。
2. audioSession と、そのオーディオセッションの状態を用いて、状態の変化を通知するためのタスクをキューに入れます。

オーディオセッションのアクティブ化は、さまざまな理由で失敗する可能性があります。たとえば、電話アプリケーションのようなより高い権限を持つアプリケーションがすでにオーディオを再生している間に、 Web アプリケーションが何らかのオーディオの再生を開始しようとする場合があります。

5.3. 選択されたオーディオセッションを更新する

context という名前のトップレベル閲覧コンテキストの選択されたオーディオセッションを更新するには、ユーザーエージェントは次の手順を実行しなければなりません。

activeAudioSessions を、context およびその子の AudioSession オブジェクトに結び付けられたすべてのオーディオセッションのうち、幅優先順で、次の両方の制約に一致するもののリストとします。
1. その状態は active です。
2. AudioSession オブジェクトの型を計算する結果が排他的型です。
activeAudioSessions が空の場合、これらの手順を中止します。
activeAudioSessions 内にオーディオセッションが 1 つだけある場合、選択されたオーディオセッションをこのオーディオセッションに設定し、これらの手順を中止します。
アサート: activeAudioSessions 内のオーディオセッションに結び付けられた任意の AudioSession オブジェクトで、audioSession という名前のものについて、 audioSession.[[type]] は auto です。

明示的な排他的型を持つオーディオセッションは、任意の時点で 1 つだけアクティブになれることが期待されます。 activeAudioSessions 内に複数のアクティブなオーディオセッションがある場合、それらの [[type]] は auto のみになり得ます。
ユーザーエージェントは、activeAudioSessions を並べ替えるために特定のヒューリスティックを適用してもよいです。
選択されたオーディオセッションを、 activeAudioSessions 内の最初のオーディオセッションに設定します。

5.4. その他のアルゴリズム

context という名前のトップレベル閲覧コンテキストのすべての AudioSession 状態を更新するには、 updatedAudioSession を用いて、次の手順を実行します。

context の選択されたオーディオセッションを更新します。
updatedType を、updatedAudioSession の型を計算する結果とします。
updatedType が排他的型でない場合、または updatedAudioSession.[[state]] が active でない場合、これらの手順を中止します。
audioSessions を、context およびその子のすべての AudioSession オブジェクトの幅優先順のリストとします。
updatedAudioSession を除く audioSessions の各 audioSession について、次の手順を実行します。
1. audioSession.[[state]] が active でない場合、これらの手順を中止します。
2. type を、audioSession の型を計算する結果とします。
3. type が排他的型でない場合、これらの手順を中止します。
4. type と updatedType がどちらも auto の場合、これらの手順を中止します。
5. audioSession を非アクティブ化します。

audioSession のオーディオセッション型を計算するには、ユーザーエージェントは次の手順を実行しなければなりません。

audioSession.[[type]] が auto でない場合、 audioSession.[[type]] を返します。
audioSession.[[elements]] のいずれかの element が play-and-record のデフォルト型を持ち、その状態が active である場合、 play-and-record を返します。
audioSession.[[elements]] のいずれかの element が playback のデフォルト型を持ち、その状態が active である場合、 playback を返します。
audioSession.[[elements]] のいずれかの element が transient-solo のデフォルト型を持ち、その状態が active である場合、 transient-solo を返します。
audioSession.[[elements]] のいずれかの element が transient のデフォルト型を持ち、その状態が active である場合、 transient を返します。
ambient を返します。

6. オーディオソースおよびシンクの統合

この節では、AudioContext、 HTMLMediaElement およびマイクの MediaStreamTrack について、オーディオセッション要素の手順とプロパティを説明します。

要素状態は次のとおりです。

それが自身の AudioSession の [[interruptedElements]] 内にある場合、interrupted。
それが可聴要素である場合、active。
それ以外の場合、inactive。

element という名前の要素を更新するには、ユーザーエージェントは次の手順を実行しなければなりません。

audioSession を element の AudioSession とします。
element の更新手順を実行します。
element が可聴要素であり、かつ audioSession.[[state]] が interrupted である場合、次の手順を実行します。
1. element を audioSession.[[interruptedElements]] に追加します。
2. element の一時停止手順を実行します。
element が audioSession.[[interruptedElements]] 内にあり、かつ audioSession.[[state]] が active である場合、次の手順を実行します。
1. element を audioSession.[[interruptedElements]] から削除します。
2. element の再開手順を実行します。

audioSession の要素の 1 つの可聴フラグが変化しているとき、ユーザーエージェントは次の手順を実行しなければなりません。

可聴フラグが true に変化している場合、audioSession のアクティブ化を試みます。
そうでなく、audioSession.[[elements]] のいずれかの element が interrupted の状態を持つ場合、これらの手順を中止します。
そうでなければ、audioSession を非アクティブ化します。

6.1. AudioContext

AudioContext は、次のプロパティを持つ要素です。

そのデフォルト型は ambient です。
その可聴フラグは、その状態が running であり、かつ宛先に非ゼロのサンプルを送信している場合、true です。
その一時停止手順は次のとおりです。
1. audioContext を AudioContext オブジェクトとします。
2. audioContext を一時停止するための制御メッセージをキューに入れます。
その再開手順は次のとおりです。
1. audioContext を AudioContext オブジェクトとします。
2. audioContext の一時停止を解除するための制御メッセージをキューに入れます。

AudioContext が作成されたとき、ユーザーエージェントは次の手順を実行しなければなりません。

audioContext を、新しく作成された AudioContext とします。
audioSession を、audioContext が作成される Window オブジェクトの AudioSession オブジェクトとします。
audioContext を audioSession.[[elements]] に追加します。

6.2. HTMLMediaElement

HTMLMediaElement は、次のプロパティを持つ要素です。

そのデフォルト型は playback です。
その可聴フラグは、再生中であり、その音量が 0 ではなく、ミュートされておらず、かつオーディオトラックを持つ場合、true です。
その一時停止手順は次のとおりです。
1. mediaElement を HTMLMediaElement オブジェクトとします。
2. mediaElement の内部一時停止手順を実行するためにタスクをキューに入れます。
その再開手順は次のとおりです。
1. mediaElement を HTMLMediaElement オブジェクトとします。
2. mediaElement の内部再生手順を実行するためにタスクをキューに入れます。

HTMLMediaElement のノード文書が変更されるとき、ユーザーエージェントは次の手順を実行しなければなりません。

mediaElement を、そのノード文書が変更される HTMLMediaElement とします。
previousWindow を、存在する場合は mediaElement の以前のノード文書に関連付けられた Window オブジェクトとし、そうでなければ null とします。
previousWindow が null でない場合、mediaElement を previousWindow の関連付けられた AudioSession.[[elements]] から削除します。
newWindow を、存在する場合は mediaElement の新しいノード文書に関連付けられた Window オブジェクトとし、そうでなければ null とします。
newWindow が null でない場合、mediaElement を newWindow の関連付けられた AudioSession.[[elements]] に追加します。

6.3. マイク MediaStreamTrack

マイクキャプチャ MediaStreamTrack は、次のプロパティを持つ要素です。

そのデフォルト型は play-and-record です。
その可聴フラグは、それが ended でもミュートでもない場合、true です。
その要素更新手順は次のとおりです。
1. track を MediaStreamTrack オブジェクトとします。
2. audioSession を track の AudioSession とします。
3. audioSession.[[type]] が play-and-record または auto でない場合、track をendします。
その一時停止手順は次のとおりです。
1. track を MediaStreamTrack オブジェクトとします。
2. track のミュート状態を設定することにより true にするためのタスクをキューに入れます。
その再開手順は次のとおりです。
1. track を MediaStreamTrack オブジェクトとします。
2. track のミュート状態を設定することにより false にするためのタスクをキューに入れます。

マイクキャプチャ MediaStreamTrack が作成されたとき、ユーザーエージェントは次の手順を実行しなければなりません。

track を、新しく作成された MediaStreamTrack とします。
audioSession を、track が作成される Window オブジェクトの AudioSession オブジェクトとします。
track を audioSession.[[elements]] に追加します。

FIXME: MediaStreamTrack ではなく、Window の mediaDevices の mediaStreamTrackSources に格納されたオーディオトラックのソースにフックするべきです。これは、転送されたマイクトラックの場合を扱うべきです。

7. プライバシーに関する考慮事項

8. セキュリティに関する考慮事項

9. 例

9.1. サイトがオーディオセッション型を先回りして "play-and-record" に設定する

navigator.audioSession.type = 'play-and-record';
// これ以降、音量は 'play-and-record' に基づいて設定される可能性があります。
...
// リモートメディアの再生を開始する
remoteVideo.srcObject = remoteMediaStream;
remoteVideo.play();
// キャプチャを開始する
navigator.mediaDevices
  .getUserMedia({ audio: true, video: true })
  .then((stream) => {
    localVideo.srcObject = stream;
  });

9.2. サイトが中断に反応する

navigator.audioSession.type = "play-and-record";
// これ以降、音量は 'play-and-record' に基づいて設定される可能性があります。
...
// リモートメディアの再生を開始する
remoteVideo.srcObject = remoteMediaStream;
remoteVideo.play();
// キャプチャを開始する
navigator.mediaDevices
  .getUserMedia({ audio: true, video: true })
  .then((stream) => {
    localVideo.srcObject = stream;
  });

navigator.audioSession.onstatechange = async () => {
  if (navigator.audioSession.state === "interrupted") {
    localVideo.pause();
    remoteVideo.pause();
    // 通話が中断されていることをユーザーに明確に示す。
    showInterruptedBanner();
    for (const track of localVideo.srcObject.getTracks()) {
      track.enabled = false;
    }
  } else {
    // 通話をいつ再開するかはユーザーに決めさせる。
    const shouldRestart = await showOptionalRestartBanner();
    if (!shouldRestart) {
      return;
    }
    for (const track of localVideo.srcObject.getTracks()) {
      track.enabled = true;
    }
    localVideo.play();
    remoteVideo.play();
  }
};

10. 謝辞

ワーキンググループは、この仕様への貴重な貢献について、次の方々に謝意を表します。

Becca Hughes
Mounir Lamouri
Zhiqiang Zhang

オーディオセッション

概要

この文書の状態

1. はじめに

2. 概念

3. `AudioSession` インターフェイス

3.1. オーディオセッション型

3.2. オーディオセッション状態

4. `Navigator` インターフェイスへの拡張

5. オーディオセッションアルゴリズム

5.1. AudioSession の type を更新する

5.2. AudioSession の state を更新する

5.3. 選択されたオーディオセッションを更新する

5.4. その他のアルゴリズム

6. オーディオソースおよびシンクの統合

6.1. AudioContext

6.2. HTMLMediaElement

6.3. マイク MediaStreamTrack

7. プライバシーに関する考慮事項

8. セキュリティに関する考慮事項

9. 例

9.1. サイトがオーディオセッション型を先回りして "play-and-record" に設定する

9.2. サイトが中断に反応する

10. 謝辞

適合性

文書規約

適合アルゴリズム

索引

この仕様で定義される用語

参照により定義される用語

参照文献

規範的参照文献

IDL 索引

オーディオセッション

概要

この文書の状態

1. はじめに

2. 概念

3. AudioSession インターフェイス

3.1. オーディオセッション型

3.2. オーディオセッション状態

4. Navigator インターフェイスへの拡張

5. オーディオセッションアルゴリズム

5.1. AudioSession の type を更新する

5.2. AudioSession の state を更新する

5.3. 選択されたオーディオセッションを更新する

5.4. その他のアルゴリズム

6. オーディオソースおよびシンクの統合

6.1. AudioContext

6.2. HTMLMediaElement

6.3. マイク MediaStreamTrack

7. プライバシーに関する考慮事項

8. セキュリティに関する考慮事項

9. 例

9.1. サイトがオーディオセッション型を先回りして "play-and-record" に設定する

9.2. サイトが中断に反応する

10. 謝辞

適合性

文書 規約

適合 アルゴリズム

索引

この仕様で定義される 用語

参照により 定義される用語

参照文献

規範的参照文献

IDL 索引

3. `AudioSession` インターフェイス

4. `Navigator` インターフェイスへの拡張

文書規約

適合アルゴリズム

この仕様で定義される用語

参照により定義される用語