AudioTrack: language 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

只讀的 AudioTrack 屬性 language 返回一個字串,用於標識音軌中使用的語言。

對於包含多種語言的音軌(例如,一部主要為英語的電影中夾雜了幾句其他語言),此屬性應為影片的主要語言。

一個指定音軌中主要使用的語言的 BCP 47 語言標籤 的字串,或者在語言未指定或未知,或者音軌不包含語音時返回空字串 ("")。

例如,如果音軌中使用的主要語言是美國英語,則該值為 "en-US"。對於巴西葡萄牙語,該值為 "pt-BR"

示例

此示例會查詢媒體元素的全部主要語言和翻譯的音軌,並返回一個包含每條音軌的 idkindlanguage 的物件的列表。

例如,這可以用來構建一個使用者介面,以便在觀看電影時選擇使用者想要收聽的語言。

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

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

規範

規範
HTML
# dom-audiotrack-language-dev

瀏覽器相容性