AudioTrack: label 属性

可用性有限

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

只读的 AudioTrack 属性 label 返回一个字符串,用于指定音频轨道的用户可读标签(如果存在);否则,返回一个空字符串。

如果轨道元数据中存在用户可读的轨道标签,则返回该字符串。否则,返回一个空字符串 ("")。

例如,一个 kind"commentary" 的轨道,其 label 可能为 "Commentary with director Mark Markmarkimark and star Donna Donnalidon"(导演 Mark Markmarkimark 和主演 Donna Donnalidon 的评论音轨)。

示例

此示例返回一个包含轨道类型和标签的数组,可用于用户界面中选择指定媒体元素的音频轨道。该列表会进行筛选,只允许某些轨道类型通过。

js
function getTrackList(el) {
  const trackList = [];
  const wantedKinds = [
    "main",
    "alternative",
    "main-desc",
    "translation",
    "commentary",
  ];

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

生成的 trackList 包含一个音频轨道数组,这些轨道的 kindwantedKinds 数组中的一种,每个条目都提供了轨道的 idkindlabel

规范

规范
HTML
# dom-audiotrack-label-dev

浏览器兼容性