MediaStreamTrack: событие unmute

Событие unmute отправляется объекту MediaStreamTrack, когда источник дорожки снова может предоставить данные медиа после периода невозможности делать это.

Это завершает состояние muted, которое началось с события mute.

Это событие не может быть отменено и не распространяется.

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.

addEventListener("unmute", (event) => {});

onunmute = (event) => {};

Общее событие Event.

В этом примере обработчики событий устанавливаются для событий mute и unmute, чтобы обнаружить, когда данные медиа не поступают от источника для объекта MediaStreamTrack, хранящегося в переменной musicTrack.

musicTrack.addEventListener(
  "mute",
  (event) => {
    document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
  },
  false,
);

musicTrack.addEventListener(
  "unmute",
  (event) => {
    document.getElementById("timeline-widget").style.backgroundColor = "#fff";
  },
  false,
);

При установке этих обработчиков событий, когда дорожка musicTrack переходит в состояние muted, элемент с идентификатором timeline-widget меняет свой цвет фона на #aaa. Когда дорожка выходит из состояния приглушения — что определяется поступлением события unmuted — цвет фона восстанавливается до белого.

Вы также можете использовать свойство обработчика событий onunmute для настройки обработчика этого события; аналогично, обработчик события onmute доступен для настройки обработчика события mute. Следующий пример демонстрирует это:

musicTrack.onmute = (event) => {
  document.getElementById("timeline-widget").style.backgroundColor = "#aaa";
};

musicTrack.onunmute = (event) => {
  document.getElementById("timeline-widget").style.backgroundColor = "#fff";
};

Следующий пример демонстрирует, как разблокировать дорожки с помощью получателей.

// Peer 1 (Receiver)
audioTrack.addEventListener("unmute", (event) => {
  // Do something in UI
});

videoTrack.addEventListener("unmute", (event) => {
  // Do something in UI
});

// Peer 2 (Sender)
const transceivers = peer.getTransceivers();

const audioTrack = transceivers[0];
audioTrack.direction = "sendrecv";

const videoTrack = transceivers[1];
videoTrack.direction = "sendrecv";

transceivers — это массив RTCRtpTransceiver, где можно найти отправленные и принятые аудио- или видеодорожки. Для получения дополнительной информации см. статью direction.

• Событие mute