Spec-Zone.ru › Web APIs

RTCDTMFSender: свойство toneBuffer

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

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

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

Свойство toneBuffer интерфейса RTCDTMFSender возвращает строку, содержащую список тонов DTMF, в настоящее время ожидающих отправки удаленному узлу через соединение RTCPeerConnection. Для добавления тонов в буфер вызовите insertDTMF().

Тона удаляются из строки по мере их воспроизведения, поэтому в списке отображаются только предстоящие тона.

Значение

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

Исключения

InvalidCharacterError DOMException

Выбрасывается, если символ не является символом тона DTMF (0-9, A-D, #, или ,).

Формат буфера тонов

Буфер тонов представляет собой строку, которая может содержать любую комбинацию символов, разрешенных стандартом DTMF.

Символы тона DTMF

Цифры от 0 до 9

Эти символы представляют цифры на кнопках телефонной клавиатуры.

Буквы A-D

Эти символы представляют кнопки «A» — «D», которые являются частью стандарта DTMF, но не включены на большинстве телефонов. Они не интерпретируются как цифры. Маленькие буквы "a"-"d" автоматически преобразуются в заглавные.

Знак решетки ("#") и звездочка ("*")

Они соответствуют имеющим аналогичное название кнопкам, которые обычно находятся в нижнем ряду телефонной клавиатуры.

Запятая (",")

Этот символ сообщает процессу набора номера о паузе в течение двух секунд перед отправкой следующего символа в буфер.

Примечание: Все другие символы не распознаются и приведут к тому, что insertDTMF() выбросит InvalidCharacterError DOMException.

Использование строк буфера тонов

Например, если вы пишете код для управления системой голосовой почты, отправляя коды DTMF, вы можете использовать строку, такую как "*,1,5555". В этом примере мы отправим "*" для запроса доступа к системе голосовой почты, затем, после паузы, отправим «1», чтобы начать воспроизведение сообщений голосовой почты, затем, после паузы, наберём «5555» в качестве PIN-кода для открытия сообщений.

Установка буфера тонов в пустую строку ("") отменяет все ожидающие коды DTMF.

Пример

ждём

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

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

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

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
toneBuffer 27 79 52 15 13.1 27 52 15 13.4 1.5 4.4

См. также

  • API WebRTC
  • Использование DTMF с WebRTC
  • RTCDTMFSender.insertDTMF()
  • RTCPeerConnection
  • RTCDTMFSender
  • RTCRtpSender

© 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/toneBuffer

Spec-Zone.ru

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