Список аудиодорожек: метод getTrackById()

Метод AudioTrackList getTrackById() возвращает первый объект AudioTrack из списка дорожек, чей идентификатор (id) совпадает с указанной строкой. Это позволяет найти определенную дорожку, если известен её идентификатор.

id

Строка, указывающая идентификатор дорожки для поиска в списке дорожек.

Объект AudioTrack, представляющий первую найденную дорожку в списке AudioTrackList, чей идентификатор id совпадает с указанной строкой. Если совпадение не найдено, метод возвращает null.

Дорожки ищутся в их естественном порядке, т.е. в порядке, определённом самим медиаресурсом, или, если ресурс не определяет порядок, в порядке, в котором дорожки объявлены медиаресурсом.

Этот пример предполагает гипотетическую игру, в которой фильмы используются в качестве кат-сцен или ключевых эпизодов. Каждый фильм имеет по одной аудиодорожке для каждого персонажа, а также одну для музыки, звуковых эффектов и т.д. Эта функция позволяет игре отключить звук определенного персонажа, чтобы настроить воспроизведение фильма в зависимости от событий в игре; если диалог персонажа не важен, он пропускается. Очевидно, это потребовало бы некоторого остроумного графического дизайна, но это гипотетическая игра.

function disableCharacter(videoElem, characterName) {
  videoElem.audioTracks.getTrackById(characterName).enabled = false;
}

Эта короткая функция получает список AudioTrackList, содержащий аудиодорожки видео, используя HTMLMediaElement.audioTracks, затем вызывает getTrackById() на нём, указав имя персонажа. Затем звук полученной дорожки отключается, устанавливая её флаг enabled в false.