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() の定義
勧告  

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
getTrackByIdChrome 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 12Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 完全対応 45Chrome Android 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7.1Samsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。