Collecte de chiffres

En plus d’activer la surveillance des chiffres et d’être informée des chiffres un par un, une application peut également demander que plusieurs chiffres soient collectés dans une mémoire tampon. L’application est avertie uniquement lorsque la mémoire tampon est pleine ou qu’une autre condition d’arrêt est remplie. La collecte de chiffres est utile pour des fonctions telles que la collecte de crédit carte de nombres. Elle est effectuée lorsqu’une application appelle lineGatherDigits, en spécifiant une mémoire tampon à remplir avec des chiffres. La collecte de chiffres prend fin lorsque l’une des conditions suivantes est remplie :

• Le nombre de chiffres demandé a été collecté.
• L’un des chiffres d’arrêt multiples est détecté. Les chiffres d’arrêt sont spécifiés sur lineGatherDigits, et le chiffre d’arrêt est également placé dans la mémoire tampon.
• L’un des deux délais d’expiration expire. Les délais d’expiration sont un délai d’expiration du premier chiffre, qui spécifie la durée maximale avant que le premier chiffre ne soit collecté, et un délai d’expiration à plusieurs chiffres, spécifiant la durée maximale entre les chiffres successifs.
• La collecte de chiffres est annulée explicitement par lineGatherDigits à nouveau avec un autre ensemble de paramètres pour démarrer une nouvelle demande de collecte ou à l’aide d’un paramètre de mémoire tampon de chiffres NULL pour annuler.

Lorsque la collecte de chiffres se termine pour une raison quelconque, un message LINE_GATHERDIGITS est envoyé à l’application qui a demandé la collecte de chiffres. Une seule demande de collecte à un seul chiffre peut être en attente sur un appel à un moment donné dans toutes les applications propriétaires de l’appel.

La collecte de chiffres et la surveillance des chiffres peuvent être activées sur le même appel en même temps. Dans ce cas, l’application reçoit un message LINE_MONITORDIGITS pour chaque chiffre détecté et un message LINE_GATHERDIGITS distinct lorsque la mémoire tampon est renvoyée.