AudioTrackList
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
AudioTrackList インターフェイスは、所与の HTML メディア要素内に含まれる音声トラックのリストを表すために使用します。 各トラックはリスト内の別々の AudioTrack オブジェクトで表します。
HTMLMediaElement.audioTracks を使用してこのオブジェクトのインスタンスを取得します。 個々のトラックは、配列構文を使用してアクセスできます。
インスタンスプロパティ
このインターフェイスは、その親インターフェイスである EventTarget からプロパティを継承しています。
length読取専用-
リスト内のトラック数。
インスタンスメソッド
このインターフェイスは、その親インターフェイスである EventTarget からメソッドを継承しています。
getTrackById()-
指定された文字列と一致する
idを持つAudioTrackList内で見つかったAudioTrackを返します。 一致が見つからない場合は、nullを返します。
イベント
addtrack-
新しい音声トラックがメディア要素に追加されたときに発生します。
change-
トラックが有効または無効にされたときに発生します。
removetrack-
音声トラックがメディア要素から取り除かれたときに発生します。
使用上のメモ
AudioTrackList を使用すると、メディア要素にある音声トラックに直接アクセスできるだけでなく、addtrack イベントと removetrack イベントにイベントハンドラーを設定できるため、メディア要素のストリームにトラックが追加されたときまたは取り除かれたときに検出できます。 詳細と例については、addtrack と removetrack を参照してください。
例
メディア要素の音声トラックリストの取得
メディア要素の AudioTrackList を取得するには、その audioTracks プロパティを使用します。
const audioTracks = document.querySelector("video").audioTracks;
トラック数の変化の監視
この例では、利用可能なチャンネル数に関する情報を表示するアプリがあります。 それを最新に保つために、 addtrack イベントと removetrack イベントのためのハンドラーを設定しています。
audioTracks.onaddtrack = updateTrackCount;
audioTracks.onremovetrack = updateTrackCount;
function updateTrackCount(event) {
trackCount = audioTracks.length;
drawTrackCountIndicator(trackCount);
}
仕様書
| Specification |
|---|
| HTML # audiotracklist-and-videotracklist-objects |
ブラウザーの互換性
Loading…