本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

在调用的任何分支上发送最多 50 个双音多频 (DTMF) 数字。信号可包括：
+ 数字 0 到 9
+ 特殊字符星号 (\$1) 和井号 (\$1)
+ 网络控制信号 A、B、C、D
+ 逗号字符 (,)。该信号在前一个信号和下一个信号之间增加了 0.5 秒的延迟。

**Topics**
+ [使用 SendDigits action](#send-digits-action)
+ [处理 ACTION\$1SUCCESSFUL events](#send-digit-success)
+ [处理 ACTION\$1FAILED events](#send-digit-fail)
+ [调用流](#send-digits-call-flow)

## 使用 SendDigits action
<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**  
*描述* — AWS Lambda 函数调用的 `CallDetails` 中参与者的 `CallId`  
*允许的值* — 有效的调用 ID  
*必填* — 是  
*默认值* – 无

**Digits**  
*描述* — 要在调用分支上发送的数字，对应于 `CallId`  
*允许的值* — 0-9、\$1、\$1、A、B、C、D、逗号 (,)  
*必填* — 是  
*默认值* – 无

**ToneDurationInMilliseconds**  
*描述* — 传输每个数字所允许的时间（以毫秒为单位）。  
*允许的值* — 介于 50 和 24000 之间的任何整数  
*必填* — 否  
*默认值* — 250

## 处理 ACTION\$1SUCCESSFUL events
<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\$1FAILED events
<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_cn/chime-sdk/latest/dg/images/send-digits-1.png)