Spec-Zone.ru › Web APIs

RTCDTMFSender: событие tonechange

Базовая поддержка Широко распространена

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие tonechange отправляется объекту RTCDTMFSender API WebRTC для указания начала и конца воспроизведения тонов DTMF, предварительно поставленных в очередь на отправку (с помощью вызова RTCDTMFSender.insertDTMF()).

Чтобы определить, какой тон начал воспроизводиться или закончился, проверьте значение свойства события tone.

Это событие не отменяется и не всплывает.

Синтаксис

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

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

ontonechange = (event) => {};

Тип события

Объект RTCDTMFToneChangeEvent. Наследуется от Event.

Событие RTCDTMFToneChangeEvent

Свойства события

В дополнение к свойствам Event, этот интерфейс предлагает следующее:

RTCDTMFToneChangeEvent.tone Только для чтения

Строка, определяющая тон, который начал воспроизводиться, или пустая строка ("") если предыдущий тон завершил воспроизведение.

Примеры

В этом примере устанавливается обработчик для события tonechange, который обновляет элемент, чтобы отобразить текущий воспроизводимый тон в его содержимом или, если все тона воспроизведены, строку «<нет>».

Это можно сделать с помощью addEventListener():

dtmfSender.addEventListener(
  "tonechange",
  (ev) => {
    let tone = ev.tone;
    if (tone === "") {
      tone = "&lt;none&gt;";
    }

    document.getElementById("playingTone").innerText = tone;
  },
  false,
);

Также можно установить обработчик события ontonechange напрямую:

dtmfSender.ontonechange = (ev) => {
  let tone = ev.tone;
  if (tone === "") {
    tone = "&lt;none&gt;";
  }

  document.getElementById("playingTone").innerText = tone;
};

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

Спецификация
WebRTC: Реальное общение в браузерах
# event-RTCDTMFSender-tonechange

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

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

Spec-Zone.ru

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