MediaStreamTrack: свойство enabled

Свойство enabled интерфейса MediaStreamTrack — это булево значение, которое true если трек разрешено отображать исходный поток, или false если нет. Это можно использовать для преднамеренной отмены звука трека.

Когда включено, данные трека выводятся из источника в пункт назначения; в противном случае выводятся пустые кадры.

В случае с аудио отключенный трек генерирует кадры тишины (то есть кадры, в которых значение каждого образца равно 0). Для видеотреков каждый кадр полностью заполняется черными пикселями.

Значение enabled, по сути, представляет то, что обычный пользователь рассматривает как состояние отмены звука для трека, тогда как свойство muted указывает на состояние, в котором трек временно не может выводить данные, например, в случае, когда кадры были потеряны во время передачи.

Когда true, enabled указывает, что трек разрешено отображать фактическое медиа в выходной поток. Когда enabled установлено на false, трек генерирует только пустые кадры.

В пустых аудиокадрах значение каждого образца равно 0. В пустых видеокадрах все пиксели имеют значение черного цвета.

Если MediaStreamTrack представляет видеовход от камеры, отключение трека, установив enabled на false, также обновляет индикаторы активности устройства, чтобы показать, что камера в настоящее время не записывает и не транслирует. Например, зелёный индикатор "в использовании" рядом с камерой на компьютерах iMac и MacBook гаснет, когда трек таким образом выключен.

Этот пример демонстрирует обработчик события click для кнопки паузы.

pauseButton.onclick = (evt) => {
  const newState = !myAudioTrack.enabled;

  pauseButton.innerHTML = newState ? "▶️" : "⏸️";
  myAudioTrack.enabled = newState;
};

Это создает переменную newState, которая является противоположностью текущего значения enabled, а затем использует её для выбора либо символа эмодзи для значка "воспроизведение", либо символа для значка "пауза" в качестве нового значения innerHTML элемента кнопки паузы.

Наконец, новое значение enabled сохраняется, делая изменение эффективным.

• API захвата медиа и потоков
• MediaStream
• MediaStreamTrack
• WebRTC