HTML | DOM Video audioTracks 属性

HTML DOM Video 对象的属性之一是 audioTracks，它是一个 AudioTrackList 对象，表示可用音频轨道的列表。AudioTrack 对象表示单个音轨。

获取 AudioTrackList

要获取 <video> 元素的 audioTracks 属性，可以使用以下 JavaScript 代码：

const audioTracks = document.querySelector('video').audioTracks;

上述代码能够获取当前 <video> 元素可用的所有音频轨道的列表。

AudioTrackList 属性和方法

AudioTrackList.length

获取可用音频轨道的数量。

const numAudioTracks = audioTracks.length;

AudioTrackList.onaddtrack

设置或获取在添加音频轨道时触发的事件处理程序。

audioTracks.onaddtrack = function() {
  console.log('A new audio track was added!');
};

AudioTrackList.onremovetrack

设置或获取移除音频轨道时触发的事件处理程序。

audioTracks.onremovetrack = function() {
  console.log('An audio track was removed!');
};

AudioTrackList.getTrackById()

通过其 ID 获取音频轨道。

const trackId = 'english';
const englishTrack = audioTracks.getTrackById(trackId);

AudioTrackList.item()

按索引获取音频轨道。

const firstTrack = audioTracks.item(0);

AudioTrack 属性和方法

包含在 AudioTrackList 中的每个音频轨道是 AudioTrack 对象。以下是 AudioTrack 对象的属性和方法：

AudioTrack.id

获取或设置音频轨道的 ID。

const englishTrack = audioTracks.getTrackById('english');
englishTrack.id = 'english_track';

AudioTrack.kind

获取音频轨道的类型，如 "alternative" 或 "main".

const firstTrack = audioTracks.item(0);
console.log(firstTrack.kind); // 输出 "main"

AudioTrack.label

获取或设置音频轨道的标签。

const englishTrack = audioTracks.getTrackById('english');
englishTrack.label = 'English';

AudioTrack.language

获取或设置音频轨道的语言。

const englishTrack = audioTracks.getTrackById('english');
englishTrack.language = 'en-US';

AudioTrack.enabled

获取或设置音频轨道的启用状态。

const firstTrack = audioTracks.item(0);
console.log(firstTrack.enabled); // 输出 true

firstTrack.enabled = false;
console.log(firstTrack.enabled); // 输出 false

结论

通过 audioTracks 属性和 AudioTrackList 对象，您可以检查和操作 <video> 元素中可用的所有音频轨道，并管理每个音频轨道的属性和方法。这将帮助您创建更好的多语言视频体验，同时也可以为有听力障碍的观众提供更好的体验。