Raccolta cifre

Oltre ad abilitare il monitoraggio delle cifre e ricevere notifiche di cifre una alla volta, un'applicazione può anche richiedere che più cifre vengano raccolte in un buffer. Solo quando il buffer è pieno o quando viene soddisfatta un'altra condizione di terminazione viene notificata all'applicazione. La raccolta di cifre è utile per funzioni come la raccolta di numeri di carta di credito. Viene eseguita quando un'applicazione chiama lineGatherDigits, specificando un buffer da riempire con cifre. La raccolta di cifre termina quando viene soddisfatta una delle condizioni seguenti:

• È stato raccolto il numero richiesto di cifre.
• Viene rilevata una delle cifre di terminazione multiple. Le cifre di terminazione vengono specificate per lineGatherDigits e anche la cifra di terminazione viene inserita nel buffer.
• Uno dei due timeout scade. I timeout sono un timeout di prima cifra, specificando la durata massima prima della raccolta della prima cifra e un timeout tra cifre, specificando la durata massima tra le cifre successive.
• La raccolta di cifre viene annullata in modo esplicito da lineGatherDigits con un altro set di parametri per avviare una nuova richiesta di raccolta o usando un parametro di buffer di cifre NULL per annullare.

Quando la raccolta di cifre termina per qualsiasi motivo, un messaggio di LINE_GATHERDIGITS viene inviato all'applicazione che ha richiesto la raccolta di cifre. Solo una richiesta di raccolta di cifre singola può essere in sospeso in una chiamata in qualsiasi momento in tutte le applicazioni proprietari della chiamata.

La raccolta di cifre e il monitoraggio delle cifre possono essere abilitati contemporaneamente nella stessa chiamata. In tal caso, l'applicazione riceverà un messaggio LINE_MONITORDIGITS per ogni cifra rilevata e un messaggio LINE_GATHERDIGITS separato quando il buffer viene inviato di nuovo.