Cijfers verzamelen

Naast het inschakelen van cijferbewaking en het één voor één op de hoogte worden gesteld van cijfers, kan een toepassing ook aanvragen dat meerdere cijfers in een buffer worden verzameld. Alleen wanneer de buffer vol is of wanneer aan een andere beëindigingsvoorwaarde wordt voldaan, wordt de toepassing hiervan op de hoogte gesteld. Het verzamelen van cijfers is handig voor functies zoals het verzamelen van creditcardnummers. Deze wordt uitgevoerd wanneer een toepassing lineGatherDigitsaanroept, waarbij een buffer wordt opgegeven die moet worden gevuld met cijfers. Het verzamelen van cijfers wordt beëindigd wanneer aan een van de volgende voorwaarden wordt voldaan:

• Het aangevraagde aantal cijfers is verzameld.
• Er is een van meerdere beëindigingsnummers gedetecteerd. De beëindigingscijfers worden opgegeven voor lineGatherDigitsen het beëindigingscijfer wordt ook in de buffer geplaatst.
• Een van de twee time-outs verloopt. De time-outs zijn een time-out van het eerste cijfer, waarbij de maximale duur wordt opgegeven voordat het eerste cijfer moet worden verzameld en een time-out tussen cijfers, waarbij de maximale duur tussen opeenvolgende cijfers wordt opgegeven.
• Het verzamelen van cijfers wordt expliciet geannuleerd door lineGatherDigits met opnieuw een andere set parameters om een nieuwe verzamelaanvraag te starten of door een NULL-cijferbufferparameter te gebruiken om te annuleren.

Wanneer het verzamelen van cijfers om welke reden dan ook wordt beëindigd, wordt er een LINE_GATHERDIGITS bericht verzonden naar de toepassing waarvoor het verzamelen van cijfers is aangevraagd. Slechts één enkelcijferig verzamelverzoek kan tegelijkertijd openstaan op een oproep in alle toepassingen die eigenaars van de oproep zijn.

Het verzamelen van cijfers en het bewaken van cijfers kan tegelijkertijd worden ingeschakeld voor dezelfde aanroep. In dat geval ontvangt de toepassing een LINE_MONITORDIGITS bericht voor elk gedetecteerd cijfer en een afzonderlijk LINE_GATHERDIGITS bericht wanneer de buffer wordt teruggestuurd.