Видеодорожка

Интерфейс VideoTrack представляет собой отдельную видеодорожку из элемента <video>.

Наиболее распространенное использование объекта VideoTrack — это переключение его свойства selected, чтобы сделать его активной видеодорожкой для элемента <video>.

selected

Булево значение, которое управляет тем, активна ли видеодорожка. Одновременно активной может быть только одна видеодорожка, поэтому установка этого свойства в true для одной дорожки, в то время как другая активна, сделает эту другую дорожку неактивной.

id Только для чтения

Строка, уникально идентифицирующая дорожку в медиаданных. Этот идентификатор можно использовать для поиска определённой дорожки в списке видеодорожек, вызвав VideoTrackList.getTrackById(). Идентификатор также может использоваться как фрагмент URL, если медиа поддерживает поиск по фрагментам медиа в соответствии со спецификацией URI фрагментов медиа Media Fragments URI specification.

kind Только для чтения

Строка, определяющая категорию, к которой относится дорожка. Например, основная видеодорожка будет иметь значение kind "main".

label Только для чтения

Строка, предоставляющая удобочитаемый ярлык для дорожки. Например, дорожка, у которой kind равно "sign", может иметь label "A sign-language interpretation". Эта строка пустая, если ярлык не предоставлен.

language Только для чтения

Строка, определяющая основной язык видеодорожки, или пустая строка, если язык неизвестен. Язык указан в формате BCP 47 (RFC 5646), например "en-US" или "pt-BR".

sourceBuffer Только для чтения

SourceBuffer , который создал дорожку. Возвращает null, если дорожка не была создана SourceBuffer или SourceBuffer был удалён из атрибута MediaSource.sourceBuffers родительского источника медиа.

Чтобы получить VideoTrack для заданного элемента медиа, используйте свойство элемента videoTracks, которое возвращает объект VideoTrackList, из которого можно получить отдельные дорожки, содержащиеся в медиа:

const el = document.querySelector("video");
const tracks = el.videoTracks;

Затем вы можете получить доступ к отдельным дорожкам медиа, используя синтаксис массивов или функции, такие как forEach().

В этом первом примере берется первая видеодорожка в медиа:

const firstTrack = tracks[0];

В следующем примере перебираются все видеодорожки медиа, активируя первую видеодорожку на предпочтительном языке пользователя (взятом из переменной userLanguage).

for (const track of tracks) {
  if (track.language === userLanguage) {
    track.selected = true;
    break;
  }
}

language находится в стандартном формате (RFC 5646). Например, для английского языка США это "en-US".