本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
SendDigits
在通話的任何一段最多發送 50 個雙音多頻(DTMF)數字。這些信號可以包括以下內容:
-
數字, 0, 到, 9
-
特殊字元星號 (*) 和磅 (#)
-
網絡控制信號 A,B,C,D
-
逗號字元 (,)。此訊號會在上一個和下一個訊號之間增加 0.5 秒的延遲時間。
使用動SendDigits作
下面的例子顯示了一個典型的SendDigits
動作:
{ "SchemaVersion": "1.0", "Actions":[ { "Type": "SendDigits", "Parameters": { "CallId": "
call-id-1
", // required "Digits": ",,*1234,56,7890ABCD#
", // required "ToneDurationInMilliseconds":100
// optional } } ] }
- CallId
-
說明 — AWS Lambda 函數叫用中
CallDetails
的參與者CallId
允許的值 — 有效的呼叫 ID
必要 — 是
預設值 — 無
- Digits
-
說明 — 要在呼叫站上發送的數字,該數字對應於
CallId
允許的值 — 0-9、*、#、A、B、C、D、逗號 (,)
必要 — 是
預設值 — 無
- ToneDurationInMilliseconds
-
說明 — 傳輸每個數字所允許的時間量 (以毫秒為單位)。
允許的值 — 介於 50 到 24000 之間的任何整數
必要 — 否
預設值:250
處理ACTION_SUCCESSFUL事件
下列範例顯示SendDigits
動作的典型ACTION_SUCCESSFUL
事件。
{ "SchemaVersion": "1.0", "Sequence":
3
, "InvocationEventType": "ACTION_SUCCESSFUL", "ActionData": { "Type": "SendDigits", "Parameters": { "Digits": "1,2A#
", "ToneDurationInMilliseconds":100
, "CallId": "call-id-1
" }, "CallDetails": { ... } } }
處理ACTION_FAILED事件
下列範例顯示SendDigits
動作的典型ACTION_FAILED
事件。
{ "SchemaVersion": "1.0", "Sequence":
3
, "InvocationEventType": "ACTION_FAILED", "ActionData": { "Type": "SendDigits", "Parameters": { "Digits": "1,2A#
", "ToneDurationInMilliseconds":20000000
, "CallId": "call-id-1
" }, "ErrorType": "InvalidActionParameter", "ErrorMessage": "ToneDuration parameter value is invalid." }, "CallDetails": { ... } } }
呼叫流程
下圖顯示了從調用者發送數字到被調用者的程序流。