AudioTrackList.getTrackById()

AudioTrackListgetTrackById() メソッドは、指定された文字列と id が一致するトラックリストから最初の AudioTrack オブジェクトを返します。 ID 文字列がわかっていれば、これで特定のトラックを見つけることができます。

構文

var theTrack = AudioTrackList.getTrackById(id);

パラメーター

id
トラックリスト内で検索するトラックの ID を示す DOMString

戻り値

指定された文字列に一致する id を持つ AudioTrackList 内で見つかった最初のトラックを示す AudioTrack オブジェクト。 一致が見つからない場合、このメソッドは null を返します。

トラックは自然な順序で検索されます。 つまり、メディアリソース自体によって定義された順序で、またはリソースが順序を定義していない場合は、メディアリソースによってトラックが宣言される相対的な順序です。

この例は、映画をゲーム内のカットシーンまたは他の重要なセットのピースとして使用する架空のゲームを示唆しています。 各映画には、各キャラクターに1つの音声トラックがあり、音楽、効果音などにも1つの音声トラックがあります。 この関数により、ゲーム内の出来事に基づいて映画の演技を調整するために、ゲームは特定のキャラクターの音声を無効にすることができます。 キャラクターの対話が適切でない場合は、省略されます。 明らかにそれは作品を作るためにいくつかの巧妙なグラフィックデザインを必要とするでしょう、しかし...これは架空のゲームです。

function disableCharacter(videoElem, characterName) {
  videoElem.audioTracks.getTrackById(characterName).enabled = false;
}

この短い関数は、HTMLMediaElement.audioTracks を使用して動画の音声トラックを含む AudioTrackList を取得し、それから getTrackById() を呼び出してキャラクターの名前を指定します。 結果としてトラックの音声は、その enabled フラグを false に設定することで無効になります。

仕様

仕様 状態 コメント
HTML Living Standard
AudioTrackList.getTrackById() の定義
現行の標準  
HTML5
AudioTrackList.getTrackById() の定義
勧告  

ブラウザーの互換性

BCD tables only load in the browser