MediaStream

The MediaStream interface represents a stream of media content. A stream consists of several tracks such as video or audio tracks. Each track is specified as an instance of MediaStreamTrack.You can obtain a MediaStream object either by using the constructor or by calling MediaDevices.getUserMedia().

Some user agents subclass this interface to provide more precise information or functionality, like in CanvasCaptureMediaStream.

Constructor

MediaStream()
Creates and returns a new MediaStream object. You can create an empty stream, a stream which is based upon an existing stream, or a stream that contains a specified list of tracks (specified as an array of MediaStreamTrack objects).

Properties

This interface inherits properties from its parent, EventTarget.

MediaStream.active Только для чтения
A Boolean value that returns true if the MediaStream is active, or false otherwise.
MediaStream.ended Только для чтения  
A Boolean value set to true if the end of the stream has been reached. This has been removed from the specification; you should instead check the value of MediaStreamTrack.readyState to see if its value is "ended" for the track or tracks you want to ensure have finished playing.
MediaStream.id Только для чтения
A DOMString containing 36 characters denoting a universally unique identifier (UUID) for the object.

Event handlers

MediaStream.onaddtrack
An EventHandler containing the action to perform when an addtrack event is fired when a new MediaStreamTrack object is added.
MediaStream.onremovetrack
An EventHandler containing the action to perform when a removetrack event is fired when a  MediaStreamTrack object is removed from it.

Methods

This interface inherits methods from its parent, EventTarget.

MediaStream.addTrack()
Stores a copy of the MediaStreamTrack given as argument. If the track has already been added to the MediaStream object, nothing happens.
MediaStream.clone()
Returns a clone of the MediaStream object. The clone will, however, have a unique value for id.
MediaStream.getAudioTracks()
Returns a list of the MediaStreamTrack objects stored in the MediaStream object that have their kind attribute set to "audio". The order is not defined, and may not only vary from one browser to another, but also from one call to another.
MediaStream.getTrackById()
Returns the track whose ID corresponds to the one given in parameters, trackid. If no parameter is given, or if no track with that ID does exist, it returns null. If several tracks have the same ID, it returns the first one.
MediaStream.getTracks()
Returns a list of all MediaStreamTrack objects stored in the MediaStream object, regardless of the value of the kind attribute. The order is not defined, and may not only vary from one browser to another, but also from one call to another.
MediaStream.getVideoTracks()
Returns a list of the MediaStreamTrack objects stored in the MediaStream object that have their kind attribute set to "video". The order is not defined, and may not only vary from one browser to another, but also from one call to another.
MediaStream.removeTrack()
Removes the MediaStreamTrack given as argument. If the track is not part of the MediaStream object, nothing happens.

Events

addtrack
Fired when a new MediaStreamTrack object is added.
Also available via the onaddtrack property.
removetrack
Fired when a MediaStreamTrack object has been removed.
Also available via the onremovetrack property.

Specifications

Specification Status Comment
Media Capture and Streams
Определение 'MediaStream' в этой спецификации.
Кандидат в рекомендации  

Browser compatibility

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
MediaStreamChrome Полная поддержка 14Edge Полная поддержка ДаFirefox Полная поддержка 15IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 18Firefox Android Полная поддержка 15Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
MediaStream() constructorChrome Полная поддержка 19Edge Полная поддержка ДаFirefox Полная поддержка 44IE Нет поддержки НетOpera Полная поддержка 42Safari Нет поддержки НетWebView Android Полная поддержка 37Chrome Android Полная поддержка 25Firefox Android Полная поддержка 42Opera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Полная поддержка 6.0
activeChrome Полная поддержка 45Edge Полная поддержка 12Firefox Полная поддержка 52IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android Полная поддержка 52Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
active eventChrome Полная поддержка 45Edge ? Firefox ? IE Нет поддержки НетOpera ? Safari ? WebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android ?
addTrackChrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка 44IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
addtrack eventChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 50Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
cloneChrome Полная поддержка 45Edge Полная поддержка 12Firefox Полная поддержка 48IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android Полная поддержка 48Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
ended
Устаревшая
Chrome Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 52.
Edge ? Firefox Нет поддержки НетIE Нет поддержки НетOpera Нет поддержки ? — 39Safari ? WebView Android Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 52.
Chrome Android Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 52.
Firefox Android Нет поддержки НетOpera Android Нет поддержки ? — 41Safari iOS ? Samsung Internet Android Полная поддержка Да
getAudioTracksChrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка 22
Замечания
Полная поддержка 22
Замечания
Замечания Prior to Firefox 64, this method returned an array of AudioStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Полная поддержка 22
Замечания
Полная поддержка 22
Замечания
Замечания Prior to Firefox 64, this method returned an array of AudioStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getTrackByIdChrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка 49IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Полная поддержка 49Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getTracks
Экспериментальная
Chrome Полная поддержка 45Edge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android Полная поддержка ДаOpera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getVideoTracks
Экспериментальная
Chrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка 22
Замечания
Полная поддержка 22
Замечания
Замечания Prior to Firefox 64, this method returned an array of VideoStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Полная поддержка 22
Замечания
Полная поддержка 22
Замечания
Замечания Prior to Firefox 64, this method returned an array of VideoStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
idChrome Нет поддержки ? — 54Edge Полная поддержка 12Firefox Полная поддержка 41IE Нет поддержки НетOpera Нет поддержки ? — 39Safari Полная поддержка ДаWebView Android Нет поддержки ? — 54Chrome Android Нет поддержки ? — 54Firefox Android Полная поддержка 41Opera Android Нет поддержки ? — 41Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
inactive eventChrome Полная поддержка 45Edge ? Firefox ? IE Нет поддержки НетOpera ? Safari ? WebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android ?
label
Устаревшая
Chrome Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 45.
Edge ? Firefox ? IE Нет поддержки НетOpera Нет поддержки НетSafari ? WebView Android Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 45.
Chrome Android Нет поддержки ? — 54
Замечания
Нет поддержки ? — 54
Замечания
Замечания Deprecated in Chrome 45.
Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android Полная поддержка Да
onactiveChrome Полная поддержка 45Edge ? Firefox ? IE Нет поддержки НетOpera ? Safari ? WebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android ?
onaddtrackChrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка 50IE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Полная поддержка 50Opera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
oninactiveChrome Полная поддержка 45Edge ? Firefox ? IE Нет поддержки НетOpera ? Safari ? WebView Android Полная поддержка 45Chrome Android Полная поддержка 45Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android ?
onremovetrackChrome Полная поддержка 26Edge Полная поддержка 12Firefox Нет поддержки НетIE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
removeTrackChrome Полная поддержка 26Edge Полная поддержка 12Firefox Полная поддержка ДаIE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка 37Chrome Android Полная поддержка 26Firefox Android Полная поддержка ДаOpera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
removetrack eventChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Нет поддержки НетIE Нет поддержки НетOpera Нет поддержки НетSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
stop
Устаревшая
Chrome Нет поддержки ? — 47Edge Полная поддержка 13Firefox ? IE Нет поддержки НетOpera Нет поддержки НетSafari ? WebView Android Нет поддержки ? — 47Chrome Android Нет поддержки ? — 47Firefox Android ? Opera Android Нет поддержки НетSafari iOS ? Samsung Internet Android Нет поддержки Нет

Легенда

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

See also