除了能啟用數字監控並逐一通知數字,應用程式也可以要求將多個數字收集到緩衝區中。 只有在緩衝區已滿或符合其他終止條件時,應用程式才會收到通知。 數字收集對於信用卡號碼收集等用途很有用。 當應用程式呼叫 lineGatherDigits時,會執行它,並指定要填入數位的緩衝區。 當下列其中一個條件成立時,數位收集就會終止:
- 已收集要求的位數。
- 偵測到多個終止數位之一。 終止位數會指定為 lineGatherDigits,而終止位數也會放在緩衝區中。
- 兩個暫停中的其中一個結束。 逾時是第一個數位逾時,指定必須收集第一個數位之前的持續時間上限,以及指定連續數位之間的最大持續時間。
- lineGatherDigits 使用另一組參數來啟動新的收集要求,或使用 NULL 數位緩衝區參數取消數位收集,來明確取消數位收集。
當數位收集因任何原因而終止時,會將 LINE_GATHERDIGITS 訊息傳送至要求數位收集的應用程式。 在任何指定時間,只有單一位數的收集要求可以在所有屬於通話擁有者的應用程式上進行未處理。
您可以同時在同一個呼叫上啟用數位收集和數位監視。 在此情況下,應用程式會為每個偵測到的數位收到一則 LINE_MONITORDIGITS 訊息,並在緩衝區傳回時收到一則單獨的 LINE_GATHERDIGITS 訊息。