Play and Get Digits

Описание

Проигрывает фалы звуковой подсказки и получает введенные абонентом цифры.

Использование

<min> <max> <tries> <timeout> <terminators> <file> <invalid_file> <var_name>
<regexp> <digit_timeout> <transfer_on_failure>

• min = Минимальное количество вводимых цифр (мин. значение 0)
• max = Максимальное значение вводимых цифр (макс. 128)
• tries = Число попыток неверного ввода
• timeout = Таймаут в милисекундах ожидания ввода цифры после окончания проигрывания голосового файла.
• terminators = используемая клавиша на клавиатуре, нажатие которой означает что набор завершен. (обычно '#')
• file = звуковой файл подсказки перед ожиданием набора.
• invalid_file = Звуковой файл, который будет проигран, если набор не соответствует ожидаемому.
• var_name = Переменная канала куда будет помещена введенная пользователем последовательность цифр.
• regexp = Регулярное выражение для отбора введенной информации.
• digit_timeout = таймаут между цифрами, превышение которого означает, что набор завершен (можно не использовать).
• transfer_on_failure = перенаправление звонка в диалплане, если все же введен неверный номер, например: 1 XML hangup (можно не использовать)

Пример

<extension name="play_and_get_digits example">
 <condition field="destination_number" expression="^(1888)$">
  <action application="play_and_get_digits" 
   data="2 3 2 7000 # conference/conf-pin.wav voicemail/vm-fail_auth.wav
   foobar ^d{3}$"/>
  <action application="sleep" data="1000"/>
  <action application="say" data="ru number pronounced ${foobar}"/>
 </condition>
</extension>

В примере выше можно ввести от двух до трех цифр. Первый голосовой файл - "Введите пин код конференции". Второй голосовой файл - "Не правильно набран номер". Переменная в которую помещается набранный номер - foobar . Регулярное выражение ^d{3}$ ожидает ввода трех любых цифр. Приложение say в окончании проговаривает введенный номер.

Данное приложение пересекается по некоторым возможностям с Read.

Приложения и инструменты диалплана FreeSWITCH