MediaStreamTrack

Интерфейс MediaStreamTrack представляет один медиа трек в потоке; обычно это адуио или видео трек, но могут использоваться и другие типы.

Свойства

В дополнение к свойствам, перечисленным ниже, MediaStreamTrack имеет свойства с ограничениями, которые можноустановить с помощью applyConstraints() и просмотреть с через getConstraints() и getSettings(). Смотрите capabilities, constraints, and settings, чтобы узнать, как правильно работать со свойствами с ограничениями. Если использовать их неправильно, ваш код будет ненадёжным.

MediaStreamTrack.contentHint

Строка, которую веб приложение может использовать для создания подсказок, какой тип данных содержит трек, чтобы их могли различать пользователи API.

MediaStreamTrack.enabled

Имеет значение true, если трек включён, то ечть может может отображать поток медиа; или false, если он выключен, то есть отображает не поток данных, а чёрное изображение без звука. Если трек отключён, это свойство можно менять, но это не будет давать никакого эффекта.

Обратите внимание: Вы можете создать стандартную функцию "заглушить звук", устанавливая свойство enabled в значение false. Свойство muted используется, когда данные отсутствуют из-за технической проблемы.

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

Возвразает объект DOMString, содержащий уникальный идентификатор (GUID) трека; генерируется браузером.

MediaStreamTrack.isolated Только для чтения

Возвращает true, если трек изолирован, то есть не доступен документу, которому принадлежит. Это случается, когда устанавливается свойство peerIdentity или трек исходит от cross-origin ресурса.

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

Возвращает объект DOMString со значением "audio", если это аудио трек или "video", если это видео трек. Не меняется, когда трек отвязывается от источника.

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

Возвращает объект DOMString, содержащий установленные агентом метки, обозначающие источник трека, например "internal microphone" (внутренний микрофон). Строка может быть пустой и является таковой, если не подключён никакой источник. Когда трек отвязывается от источника, метка не меняется.

MediaStreamTrack.muted Только для чтения

Возвращает true, если трек не может предоставить данные по техническим причинам.

Обратите внимание: Вы можете создать стандартную функцию "заглушить звук", устанавливая свойство enabled в значение false, и возвращать звук, снова устанавливая его в значение true.

MediaStreamTrack.readonly Только для чтения

Возвращает true, если трек предназначен только для чтения (например, если его источник - видео файл или камера, настройки которой не могут быть изменены), иначе false.

MediaStreamTrack.readyState Только для чтения

Возвращает одно из следующих значений, обозначающих статус трека:

• "live" означает, что источник подключен и делает всё, чтобы предоставить данные в реальном времени. В этом случае, поток данных можно включать и выключать с помощью свойство enabled.
• "ended" означает, что источник больше не предоставляет и больше не будет предоставлять данные.

MediaStreamTrack.remote Только для чтения

Имеет значение true, если источником трека является RTCPeerConnection, иначе false.

Методы

MediaStreamTrack.applyConstraints()

Позволяет приложению указывать желательные и/или допустимые диапазоны значений для любого количества свойств с ограничениями объекта MediaStreamTrack.

MediaStreamTrack.clone()

Возвращает копию объекта MediaStreamTrack.

MediaStreamTrack.getCapabilities()

Возвращает список свойств с ограничениями, доступных объекту MediaStreamTrack.

MediaStreamTrack.getConstraints()

Возвращает объект MediaTrackConstraints, содержащий установленные ограничения на трек; возвращаемое значение удовлетворяет ограничениям, установленным методом applyConstraints().

MediaStreamTrack.getSettings()

Возвращает объект MediaTrackSettings, содержащий тукщее значение всех свойств с ограничениями объекта MediaStreamTrack.

MediaStreamTrack.stop()

Останавливает проигрывание источника, к которому привязан трек. И источник, и трек отвязываются. Состояние трека устанавливается в значение ended.

События

ended

Вызывается, когда проигрывание трека останавливается (когда значение readyState становится ended).
Обработчик может быть установлен как свойство onended.

mute

Вызывается, когда muted принимает значение true, что означает, что трек временно не может предоставлять данне (например, при плохом подключении сети).
Обработчик может быть установлен как свойство onmute.

isolationchange

Вызывается, когда свойство isolated принимает значение true из-за того, что документ больше не имеет разрешение на доступ к треку.
Обработчик может быть установлен как свойство onisolationchange.

overconstrained

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

unmute

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

Спецификации

Поддержка браузерами

Смотрите также

• Media Capture and Streams API
• MediaStream