Поток медиаданных: метод getAudioTracks()
Базовая Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с сентября 2017 года.
Метод getAudioTracks() интерфейса MediaStream возвращает последовательность, представляющую все объекты MediaStreamTrack в наборе треков этого потока, где MediaStreamTrack.kind имеет значение audio.
Синтаксис
getAudioTracks()
Параметры
Нет.
Возвращаемое значение
Массив объектов MediaStreamTrack, по одному для каждого аудиотрека, содержащегося в потоке. Аудиотреки — это те треки, у которых свойство kind равно audio. Массив пуст, если поток не содержит аудиотреков.
Примечание: Порядок возвращаемых треков не определён спецификацией и может меняться при каждом вызове getAudioTracks().
Ранние версии этого API включали специальный интерфейс AudioStreamTrack, который использовался в качестве типа для каждого элемента в списке аудиопотоков; однако, он был объединён с основным интерфейсом MediaStreamTrack.
Примеры
В этом примере с помощью getUserMedia() извлекается аудио и видео с веб-камеры в поток, этот поток прикрепляется к элементу <video>, а затем устанавливается таймер, который после истечения срока действия останавливает первый найденный аудиотрек в потоке.
navigator.mediaDevices
.getUserMedia({ audio: true, video: true })
.then((mediaStream) => {
document.querySelector("video").srcObject = mediaStream;
// Stop the audio stream after 5 seconds
setTimeout(() => {
const tracks = mediaStream.getAudioTracks();
tracks[0].stop();
}, 5000);
});
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getAudioTracks |
26 | 12 | 22До Firefox 64, этот метод возвращал массив объектовAudioStreamTrack. Однако, MediaStreamTrack теперь включает функциональность этого интерфейса. |
15 | 11 | 26 | 22До Firefox для Android 64, этот метод возвращал массив объектовAudioStreamTrack. Однако, MediaStreamTrack теперь включает функциональность этого интерфейса. |
14 | 11 | 1.5 | 37 |
© 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/getAudioTracks