Spec-Zone.ru › Web APIs

Поток медиаданных: метод 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);
  });

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

Спецификация
Захват медиаданных и потоки
# dom-mediastream-getaudiotracks

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

Рабочие столы Мобильные устройства
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API