AudioTrack.language

読み取り専用の AudioTrack の language プロパティは、音声トラックで使用されている言語を識別する文字列を返します。複数の言語を含むトラック（他の言語で数行が話されている英語の映画など）の場合は、これが動画の主要言語になります。

構文

var audioTrackLanguage = AudioTrack.language;

値

音声トラックで使用される主要言語の BCP 47（RFC 5646）形式の言語タグを指定する DOMString。言語が指定されていないか知られていない場合や、トラックにスピーチが含まれていない場合は空文字列（""）。

例えば、トラックで使用されている主要言語がアメリカ英語の場合、この値は "en-US" になります。ブラジルポルトガル語の場合、値は "pt-BR" になります。

BCD tables only load in the browser

この例では、メディア要素の主要言語と翻訳された音声トラックのすべてを検索し、それらの各トラックの id、kind、language を含むオブジェクトのリストを返します。

これは、例えば、映画を見ながら、ユーザーが聞きたい言語を選択するためのユーザーインターフェイスを構築するために使用できます。

function getAvailableLanguages(el) {
  var trackList = [];
  const wantedKinds = [
    "main", "translation"
  ];

  el.audioTracks.forEach(function(track) {
    if (wantedKinds.includes(track.kind)) {
      trackList.push({
        id: track.id,
        kind: track.kind,
        language: track.language
      });
    }
  });
  return trackList;
}

仕様	状態	コメント
HTML Living Standard AudioTrack.language の定義	現行の標準
HTML5 AudioTrack.language の定義	勧告