RTCDTMFSender: событие tonechange
Базовая поддержка Широко распространена
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.
Событие tonechange отправляется объекту RTCDTMFSender API WebRTC для указания начала и конца воспроизведения тонов DTMF, предварительно поставленных в очередь на отправку (с помощью вызова RTCDTMFSender.insertDTMF()).
Чтобы определить, какой тон начал воспроизводиться или закончился, проверьте значение свойства события tone.
Это событие не отменяется и не всплывает.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика событий.
addEventListener("tonechange", (event) => {});
ontonechange = (event) => {};
Тип события
Объект RTCDTMFToneChangeEvent. Наследуется от Event.
Свойства события
В дополнение к свойствам Event, этот интерфейс предлагает следующее:
-
RTCDTMFToneChangeEvent.toneТолько для чтения -
Строка, определяющая тон, который начал воспроизводиться, или пустая строка (
"") если предыдущий тон завершил воспроизведение.
Примеры
В этом примере устанавливается обработчик для события tonechange, который обновляет элемент, чтобы отобразить текущий воспроизводимый тон в его содержимом или, если все тона воспроизведены, строку «<нет>».
Это можно сделать с помощью addEventListener():
dtmfSender.addEventListener(
"tonechange",
(ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
},
false,
);
Также можно установить обработчик события ontonechange напрямую:
dtmfSender.ontonechange = (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
};
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
tonechange_event |
27 | 79 | 52 | 15 | 13.1 | 27 | 52 | 15 | 13.4 | 1.5 | 4.4 |
© 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/RTCDTMFSender/tonechange_event