Recopilación de dígitos

Además de habilitar la supervisión de dígitos y recibir notificaciones de dígitos de uno en uno, una aplicación también puede solicitar que se recopilen varios dígitos en un búfer. Solo cuando el búfer está lleno o cuando se cumple alguna otra condición de terminación, se notifica a la aplicación. La recopilación de dígitos es útil para funciones como la recopilación de números de tarjeta de crédito. Se realiza cuando una aplicación llama a lineGatherDigits, especificando un búfer para rellenar con dígitos. La recopilación de dígitos finaliza cuando se cumple una de las condiciones siguientes:

• Se ha recopilado el número solicitado de dígitos.
• Se detecta uno de varios dígitos de terminación. Los dígitos de terminación se especifican para lineGatherDigits y el dígito de terminación también se coloca en el búfer.
• Expira uno de los dos tiempos de espera. Los tiempos de espera son un tiempo de espera de primer dígito, especificando la duración máxima antes de que se deba recopilar el primer dígito y un tiempo de espera entre dígitos, especificando la duración máxima entre dígitos sucesivos.
• La recopilación de dígitos se cancela explícitamente mediante lineGatherDigits de nuevo con otro conjunto de parámetros para iniciar una nueva solicitud de recopilación o mediante un parámetro de búfer de dígitos NULL para cancelar.

Cuando la recopilación de dígitos finaliza por cualquier motivo, se envía un mensaje de LINE_GATHERDIGITS a la aplicación que solicitó la recopilación de dígitos. Solo una solicitud de recopilación de dígitos puede estar pendiente en una llamada en cualquier momento dado en todas las aplicaciones que sean propietarios de la llamada.

La recopilación de dígitos y la supervisión de dígitos se pueden habilitar en la misma llamada al mismo tiempo. En ese caso, la aplicación recibirá un mensaje de LINE_MONITORDIGITS para cada dígito detectado y un mensaje de LINE_GATHERDIGITS independiente cuando se devuelva el búfer.