--- title: AudioTrack.language slug: Web/API/AudioTrack/language tags: - API - Audio - AudioTrack - HTML DOM - Language - Localization - Media - Property - Read-only - Reference - Translated - Translation - track translation_of: Web/API/AudioTrack/language ---
{{APIRef("HTML DOM")}}

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

構文

var audioTrackLanguage = AudioTrack.language;

値

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

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

例

この例では、メディア要素の主要言語と翻訳された音声トラックのすべてを検索し、それらの各トラックの {{domxref("AudioTrack.id", "id")}}、{{domxref("AudioTrack.kind", "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;
}

仕様

仕様 状態 コメント
{{SpecName('HTML WHATWG', 'media.html#dom-audiotrack-language', 'AudioTrack.language')}} {{Spec2('HTML WHATWG')}}  
{{SpecName('HTML5 W3C', 'embedded-content-0.html#dom-audiotrack-language', 'AudioTrack.language')}} {{Spec2('HTML5 W3C')}}  

ブラウザーの互換性

{{Compat("api.AudioTrack.language")}}