數位收集

除了啟用數位監視，以及一次收到一個數位的通知，應用程式也可以要求在緩衝區中收集多個數位。 只有在緩衝區已滿或符合其他終止條件時，應用程式才會收到通知。 數位收集對於信用卡號碼收集等函式很有用。 當應用程式呼叫 lineGatherDigits時，它會指定要填滿數位的緩衝區時執行。 當下列其中一個條件成立時，數位收集就會終止：

• 已收集要求的位數。
• 偵測到其中一個終止數位。 終止數位會指定給 lineGatherDigits，而終止數位也會放在緩衝區中。
• 兩個逾時之一到期。 逾時是第一個數位逾時，指定必須收集第一個數位之前的持續時間上限，以及指定連續數位之間的最大持續時間的位數逾時。
• 再次使用另一組參數來啟動新的收集要求，或是使用 Null 數位緩衝區參數取消，以明確取消數位收集。

當數位收集因任何原因而終止時， LINE_GATHERDIGITS 訊息會傳送至要求數位收集的應用程式。 在任何指定時間，只有單一數位收集要求可以在所有屬於通話擁有者的應用程式上進行未處理。

您可以同時在同一個呼叫上啟用數位收集和數位監視。 在此情況下，當緩衝區傳回時，應用程式會收到每個偵測到數位的 LINE_MONITORDIGITS 訊息，以及個別的LINE_GATHERDIGITS訊息。