MediaStreamTrack
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Интерфейс 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
.
Спецификации
Specification |
---|
Media Capture and Streams # mediastreamtrack |
Совместимость с браузерами
BCD tables only load in the browser