RTCDTMFSender: свойство toneBuffer
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.
Свойство toneBuffer интерфейса RTCDTMFSender возвращает строку, содержащую список тонов DTMF, в настоящее время ожидающих отправки удаленному узлу через соединение RTCPeerConnection. Для добавления тонов в буфер вызовите insertDTMF().
Тона удаляются из строки по мере их воспроизведения, поэтому в списке отображаются только предстоящие тона.
Значение
Строка, перечисляющая тона, которые должны быть воспроизведены. Если строка пуста, то нет ожидающих воспроизведения тонов.
Исключения
-
InvalidCharacterErrorDOMException -
Выбрасывается, если символ не является символом тона 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.
Пример
ждём
Спецификации
Совместимость с браузерами
| Рабочий стол | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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