AudioTrack:language 属性

有限可用性

此功能不是基线,因为它在一些最广泛使用的浏览器中不起作用。

只读的AudioTrack 属性language返回一个字符串,标识音频轨道中使用的语言。

对于包含多种语言的轨道(例如,英语电影中包含几句其他语言的对白),这应该是视频的主要语言。

一个字符串,指定音频轨道中主要语言的 BCP 47 (RFC 5646) 格式语言标签,如果语言未指定或未知,或者轨道不包含语音,则为空字符串 ("")。

例如,如果轨道中使用的主要语言是美国英语,则此值为 "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

浏览器兼容性

BCD 表格仅在浏览器中加载