MediaStreamAudioSourceNode

Baseline Широко доступно

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

Интерфейс MediaStreamAudioSourceNode — это тип AudioNode, который работает как источник звука, чья медиа поступает из MediaStream, полученного с помощью API WebRTC или Media Capture and Streams.

Эта медиа может поступать с микрофона (через getUserMedia()) или от удалённого участника по вызову WebRTC (используя аудиодорожки RTCPeerConnection).

У MediaStreamAudioSourceNode нет входных и ровно один выходной поток, и он создаётся с помощью метода AudioContext.createMediaStreamSource().

MediaStreamAudioSourceNode берёт звук с первой MediaStreamTrack, значение атрибута kind которой audio. См. Порядок следования дорожек для получения более подробной информации об порядке дорожек.

Количество каналов, выводимых узлом, соответствует количеству дорожек в выбранной аудиодорожке.

Количество входных потоков	`0`
Количество выходных потоков	`1`
Количество каналов	2 (но обратите внимание, что `AudioNode.channelCount` используется только для преобразования аудио `AudioNode` сигналов в верхнее и нижнее разрешение, а у `MediaStreamAudioSourceNode` нет входа)

Конструктор

MediaStreamAudioSourceNode(): Создаёт новый экземпляр объекта MediaStreamAudioSourceNode с указанными параметрами.

Свойства экземпляра

Помимо следующих свойств, MediaStreamAudioSourceNode наследует свойства своего родителя, AudioNode.

mediaStream Только для чтения: Используемый MediaStream при создании этого MediaStreamAudioSourceNode.

Методы экземпляра

Наследует методы от родителя, AudioNode.

Примечания к использованию

Порядок следования дорожек

Для целей интерфейса MediaStreamTrackAudioSourceNode порядок аудиодорожек в потоке определяется выбором дорожек, у которых атрибут kind равен audio, затем сортировка дорожек по значениям их свойства id в порядке кодовых точек Unicode (по существу, в алфавитном или лексикографическом порядке, для идентификаторов, являющихся простыми алфавитно-цифровыми строками).

Первой, таким образом, является дорожка, у которой id встречается первой, когда идентификаторы дорожек отсортированы по кодовым точкам Unicode.

Однако важно отметить, что правило, определяющее этот порядок, было добавлено намного позже того, как этот интерфейс был впервые представлен в API Web Audio. Поэтому вы не можете легко полагаться на то, что порядок будет одинаковым в разных браузерах или версиях браузеров.

Интерфейс MediaStreamTrackAudioSourceNode похож на MediaStreamAudioSourceNode, но избегает этой проблемы, позволяя вам указать, какую дорожку вы хотите использовать.

Пример

См. AudioContext.createMediaStreamSource() для примера кода, использующего этот объект.

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

Спецификация
Web Audio API # MediaStreamAudioSourceNode

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в iOS	Samsung Internet	WebView Android
`MediaStreamAudioSourceNode`	55	79	53	42	14.1	55	53	42	14.5	6.0	55
`MediaStreamAudioSourceNode`	22	12	25	15	11	25	25	14	11	1.5	4.4
`mediaStream`	22	79	70	15	11	25	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/MediaStreamAudioSourceNode