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

浏览器兼容性