Сбор цифр
Помимо включения мониторинга цифр и уведомления о цифрах по одной за раз, приложение также может запросить сбор нескольких цифр в буфере. Приложение уведомляется только при заполнении буфера или выполнении какого-либо другого условия завершения. Сбор цифр полезен для таких функций, как кредитный карта сбор чисел. Он выполняется, когда приложение вызывает lineGatherDigits, указывая буфер для заполнения цифрами. Сбор цифр завершается, если выполняется одно из следующих условий:
- Запрошенное количество цифр было собрано.
- Обнаружена одна из нескольких цифр завершения. Цифры завершения указываются в lineGatherDigits, а цифра завершения также помещается в буфер.
- Истекает одно из двух тайм-аутов. Время ожидания — это время ожидания первой цифры, указывающее максимальную длительность до сбора первой цифры и время ожидания между цифрами, указывающее максимальную длительность между последовательными цифрами.
- Сбор цифр явно отменяется методом lineGatherDigits с другим набором параметров для запуска нового запроса на сбор или с помощью параметра буфера цифр NULL для отмены.
Когда сбор цифр завершается по какой-либо причине, LINE_GATHERDIGITS сообщение отправляется приложению, которое запросило сбор цифр. При вызове в любой момент времени во всех приложениях, которые являются владельцами звонка, может быть невыполнена только одна цифра.
Сбор цифр и мониторинг цифр можно включить в одном вызове одновременно. В этом случае приложение получит LINE_MONITORDIGITS сообщение для каждой обнаруженной цифры и отдельное сообщение LINE_GATHERDIGITS при обратной отправке буфера.