本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# SendDigits
<a name="send-digits"></a>

在通話的任何腿上傳送最多 50 個雙音多頻率 (DTMF) 數字。這些訊號可以包含下列項目：
+ 數字 0 到 9
+ 特殊字元星號 (\*) 和井字號 (\#)
+ 網路控制訊號 A、B、C、D
+ 逗號字元 (，)。此訊號會在先前和下一個訊號之間新增 0.5 秒的延遲。

**Topics**
+ [使用 SendDigits動作](#send-digits-action)
+ [處理ACTION\_SUCCESSFUL事件](#send-digit-success)
+ [處理ACTION\_FAILED事件](#send-digit-fail)
+ [呼叫流程](#send-digits-call-flow)

## 使用 SendDigits動作
<a name="send-digits-action"></a>

下列範例顯示典型`SendDigits`動作：

```
{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "SendDigits",
            "Parameters": {
                "CallId": "{{call-id-1}}", // required
                "Digits": "{{,,*1234,56,7890ABCD#}}", // required
                "ToneDurationInMilliseconds": {{100}} // optional
            }
        }
    ]
}
```

**CallId**  
*描述* – 函數調用 `CallId` 中參與者`CallDetails`的 AWS Lambda   
*允許的值* – 有效的呼叫 ID  
*必要* – 是  
*預設值* — 無

**Digits**  
*描述* – 要在對應至 的通話腿上傳送的數字 `CallId`  
*允許的值* – 0-9、\*、\#、A、B、C、D、逗號 (、)  
*必要* – 是  
*預設值* — 無

**ToneDurationInMilliseconds**  
*描述* – 允許傳輸每個數字的時間，以毫秒為單位。  
*允許的值* – 介於 50 和 24000 之間的任何整數  
*必要* – 否  
*預設值* – 250

## 處理ACTION\_SUCCESSFUL事件
<a name="send-digit-success"></a>

下列範例顯示 `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事件
<a name="send-digit-fail"></a>

下列範例顯示 `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": {
        ...
        }
    }
}
```

## 呼叫流程
<a name="send-digits-call-flow"></a>

下圖顯示從來電者將數字傳送至受話方的程式流程。

![顯示 SendDigits動作之程式流程的圖表。](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/send-digits-1.png)