AudioTrack:label 属性

可用性有限

此功能并非基线功能,因为它在一些使用最广泛的浏览器中无法正常工作。

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

如果轨道元数据中可用,则为指定轨道用户可读标签的字符串。否则,返回空字符串 ("")。

例如,一个 kind"commentary" 的轨道可能具有 label,例如 "Commentary with director Mark Markmarkimark and star 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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。