MediaStreamTrack: событие mute

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

Когда дорожка снова сможет выводить медиаданные, отправляется событие unmute.

В период между событием mute и событием unmute значение свойства дорожки muted равно true.

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

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

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

onmute = (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, цвет фона элемента с ID timeline-widget изменяется на #aaa. Когда дорожка выходит из состояния выключения звука (обнаружено событием unmute), цвет фона восстанавливается до белого.

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

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("mute", (event) => {
  // Do something in UI
});

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

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

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

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

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

• unmute событие
• direction