MediaStream

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2017 года.

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

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

Конструктор

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 деактивирован.

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

Спецификация
Захват медиа и потоки # mediastream

Совместимость с браузерами

	Настольные					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`MediaStream`	5521	1279	44	4215	11	5525	42	4214	11	6.01.5	554.4
`MediaStream`	5521	1279	15	4215	11	5525	15	4214	11	6.01.5	554.4
`active`	42	12	52	29	11	42	52	29	11	4.0	42
`active_event`	42	12	Нет	29	Нет	42	Нет	29	Нет	4.0	42
`addTrack`	26	12	44	15	11	26	44	14	11	1.5	37
`addtrack_event`	26	12	50	15	11	26	50	14	11	1.5	4.4
`clone`	35	12	48	22	11	35	48	22	11	3.0	37
`getAudioTracks`	26	12	22 До Firefox 64, этот метод возвращал массив объектов `AudioStreamTrack`. Однако, `MediaStreamTrack` теперь включает в себя функциональность этого интерфейса.	15	11	26	22 До Firefox для Android 64, этот метод возвращал массив объектов `AudioStreamTrack`. Однако, `MediaStreamTrack` теперь включает в себя функциональность этого интерфейса.	14	11	1.5	37
`getTrackById`	26	12	49	15	11	26	49	14	11	1.5	37
`getTracks`	38	12	34	25	11	38	34	25	11	3.0	38
`getVideoTracks`	26	12	22 До Firefox 64, этот метод возвращал массив объектов `VideoStreamTrack`. Однако, `MediaStreamTrack` теперь включает в себя функциональность этого интерфейса.	15	11	26	22 До Firefox для Android 64, этот метод возвращал массив объектов `VideoStreamTrack`. Однако, `MediaStreamTrack` теперь включает в себя функциональность этого интерфейса.	14	11	1.5	37
`id`	26	12	41	15	11	26	41	14	11	1.5	4.4
`inactive_event`	42	12	Нет	29	Нет	42	Нет	29	Нет	4.0	42
`removeTrack`	26	12	44	15	11	26	44	14	11	1.5	37
`removetrack_event`	26	12	72 59–72 До Firefox 72, обработчик событий был доступен, но не действовал.	15	11	26	79 59–79 До Firefox для Android 79, обработчик событий был доступен, но не действовал.	14	11	1.5	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaStream