Интерфейс 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 | Status | Comment |
---|---|---|
Media Capture and Streams Определение 'MediaStreamTrack' в этой спецификации. |
Кандидат в рекомендации | Initial definition |
Identity for WebRTC Определение 'Isolated tracks' в этой спецификации. |
Кандидат в рекомендации | Additional properties for isolated track support |
Поддержка браузерами
BCD tables only load in the browser