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.

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

Specification Status Comment
Media Capture and Streams
Определение 'MediaStreamTrack' в этой спецификации.
Кандидат в рекомендации Initial definition
Identity for WebRTC
Определение 'Isolated tracks' в этой спецификации.
Кандидат в рекомендации Additional properties for isolated track support

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
MediaStreamTrackChrome Полная поддержка 29Edge Полная поддержка 12Firefox Полная поддержка 22IE Нет поддержки НетOpera Полная поддержка 16Safari Полная поддержка 11WebView Android Полная поддержка ≤37Chrome Android Полная поддержка 29Firefox Android Полная поддержка 22Opera Android Полная поддержка 16Safari iOS Полная поддержка 11Samsung Internet Android Полная поддержка 2.0
applyConstraintsChrome Полная поддержка 63Edge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка 46Safari Полная поддержка ДаWebView Android Полная поддержка 63Chrome Android Полная поддержка 63Firefox Android Полная поддержка 50Opera Android Полная поддержка 43Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 7.0
cloneChrome Полная поддержка 45Edge Полная поддержка 12Firefox Полная поддержка 48IE Нет поддержки НетOpera Полная поддержка 32Safari Полная поддержка ДаWebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android Полная поддержка ДаOpera Android Полная поддержка 32Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 5.0
contentHintChrome Полная поддержка 60Edge Полная поддержка ≤79Firefox ? IE Нет поддержки НетOpera Полная поддержка 47Safari ? WebView Android Полная поддержка 60Chrome Android Полная поддержка 60Firefox Android ? Opera Android Полная поддержка 44Safari iOS ? Samsung Internet Android Полная поддержка 8.0
enabledChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 24IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 24Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
ended eventChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 50Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getCapabilitiesChrome Полная поддержка 66Edge Полная поддержка 12Firefox Нет поддержки НетIE Нет поддержки НетOpera Полная поддержка 53Safari Полная поддержка ДаWebView Android Полная поддержка 66Chrome Android Полная поддержка 66Firefox Android Нет поддержки НетOpera Android Полная поддержка 47Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 9.0
getConstraintsChrome Полная поддержка 53Edge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 53Chrome Android Полная поддержка 52Firefox Android Полная поддержка 50Opera Android Полная поддержка ДаSafari iOS Нет поддержки НетSamsung Internet Android Полная поддержка 6.0
getSettingsChrome Полная поддержка 61Edge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка 48Safari Полная поддержка ДаWebView Android Полная поддержка 61Chrome Android Полная поддержка 61Firefox Android Полная поддержка 50Opera Android Полная поддержка 45Safari iOS Полная поддержка 11Samsung Internet Android Полная поддержка 8.0
getSources
Устаревшая
Chrome Нет поддержки ? — 56Edge ? Firefox Нет поддержки НетIE Нет поддержки НетOpera Нет поддержки ? — 43Safari ? WebView Android Нет поддержки ? — 56Chrome Android Полная поддержка 56Firefox Android ? Opera Android Нет поддержки ? — 43Safari iOS ? Samsung Internet Android Полная поддержка 6.0
idChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка ДаOpera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
isolatedChrome ? Edge ? Firefox Нет поддержки НетIE Нет поддержки НетOpera ? Safari ? WebView Android ? Chrome Android ? Firefox Android Нет поддержки НетOpera Android ? Safari iOS ? Samsung Internet Android ?
kindChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка ДаOpera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
labelChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка ДаOpera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
mute eventChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 59IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 59Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
mutedChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 59IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 59Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
onendedChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 50Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
onisolationchangeChrome ? Edge ? Firefox Нет поддержки НетIE Нет поддержки НетOpera ? Safari ? WebView Android ? Chrome Android ? Firefox Android Нет поддержки НетOpera Android ? Safari iOS ? Samsung Internet Android ?
onmuteChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 59IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 59Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
onoverconstrained
УстаревшаяНестандартная
Chrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android ? Opera Android ? Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
onunmuteChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 59IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 59Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
readonly
Устаревшая
Chrome ? Edge Полная поддержка 12Firefox ? IE Нет поддержки НетOpera ? Safari ? WebView Android ? Chrome Android ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
readyStateChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 50Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
remote
УстаревшаяНестандартная
Chrome Нет поддержки 48 — 59Edge Нет поддержки 12 — 79Firefox Полная поддержка ДаIE Нет поддержки НетOpera Нет поддержки 35 — 46Safari ? WebView Android Нет поддержки 48 — 59Chrome Android Нет поддержки 48 — 59Firefox Android Полная поддержка ДаOpera Android Нет поддержки 35 — 43Safari iOS ? Samsung Internet Android Нет поддержки 5.0 — 7.0
stopChrome Полная поддержка 61Edge Полная поддержка 12Firefox Полная поддержка 34IE Нет поддержки НетOpera Полная поддержка 45Safari Полная поддержка ДаWebView Android Полная поддержка 61Chrome Android Полная поддержка 61Firefox Android Полная поддержка 34Opera Android Полная поддержка 43Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка 8.0
unmute eventChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 59IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 59Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Совместимость неизвестна  
Совместимость неизвестна
Нестандартная. Ожидается плохая кросс-браузерная поддержка.
Нестандартная. Ожидается плохая кросс-браузерная поддержка.
Устаревшая. Не следует использовать в новых веб-сайтах
Устаревшая. Не следует использовать в новых веб-сайтах

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