Интерфейс MediaStreamпредставляет собой поток медиаконтента. Поток состоит из нескольких дорожек , например видео- или аудиодорожек. Каждая дорожка указывается как экземпляр MediaStreamTrack.

Вы можете получить MediaStreamобъект либо с помощью конструктора, либо путем вызова таких функций, как MediaDevices.getUserMedia(), MediaDevices.getDisplayMedia()или HTMLCanvasElement.captureStream().

Некоторые пользовательские агенты подклассифицируют этот интерфейс для предоставления более точной информации или функций, как в CanvasCaptureMediaStreamTrack.

EventTarget MediaStream Конструктор MediaStream() Создает и возвращает новый MediaStreamобъект. Вы можете создать пустой поток, поток, основанный на существующем потоке, или поток, содержащий указанный список дорожек (заданный как массив объектов MediaStreamTrack).

Свойства экземпляра Этот интерфейс наследует свойства своего родителя, EventTarget.

MediaStream.active Только чтение Логическое значение, которое возвращается , trueесли MediaStreamактивен или falseнет.

MediaStream.id Только чтение Строка, содержащая 36-значный универсальный уникальный идентификатор ( UUID ) объекта.

Методы экземпляра Этот интерфейс наследует методы от своего родителя, EventTarget.

MediaStream.addTrack() Сохраняет копию данного параметра MediaStreamTrackв качестве аргумента. Если трек уже добавлен к объекту MediaStream, ничего не происходит.

MediaStream.clone() Возвращает клон объекта MediaStream. Однако клон будет иметь уникальное значение для id.

MediaStream.getAudioTracks() Возвращает список объектов, MediaStreamTrackхранящихся в MediaStreamобъекте, для которых kindустановлен атрибут audio. Порядок не определен и может меняться не только от одного браузера к другому, но и от одного вызова к другому.

MediaStream.getTrackById() Возвращает трек, идентификатор которого соответствует указанному в параметрах trackid. Если параметр не указан или трек с таким идентификатором не существует, возвращается null. Если несколько треков имеют одинаковый идентификатор, возвращается первый.

MediaStream.getTracks() Возвращает список всех MediaStreamTrackобъектов, хранящихся в MediaStreamобъекте, независимо от значения атрибута kind. Порядок не определен и может меняться не только от одного браузера к другому, но и от одного вызова к другому.

MediaStream.getVideoTracks() Возвращает список объектов, MediaStreamTrackхранящихся в MediaStreamобъекте, для которых kindустановлен атрибут «video». Порядок не определен и может меняться не только от одного браузера к другому, но и от одного вызова к другому.

MediaStream.removeTrack() Удаляет MediaStreamTrackданное в качестве аргумента. Если дорожка не является частью объекта MediaStream, ничего не происходит.

События addtrack MediaStreamTrackВызывается при добавлении нового объекта.

removetrack Вызывается, когда MediaStreamTrackобъект был удален.

active Запускается при активации MediaStream.

inactive Запускается, когда MediaStream деактивируется.