

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

任意の通話レッグで、最大 50 のデュアルトーンマルチ周波数 (DTMF) ディジットを送信できます。シグナルには以下を含めることができます。
+ 0 から 9 までの数字
+ 特殊文字: 星 (\$1) とポンド (\$1)
+ ネットワーク制御シグナル A、B、C、D
+ カンマ文字 (,)。このシグナルにより、前のシグナルと次のシグナルの間に 0.5 秒の遅延が追加されます。

**Topics**
+ [SendDigits アクションの使用](#send-digits-action)
+ [ACTION\$1SUCCESSFUL イベントの処理](#send-digit-success)
+ [ACTION\$1FAILED イベントの処理](#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**  
説明 – AWS Lambda 関数呼び出しの `CallDetails` における、参加者の `CallId`  
*使用できる値* – 有効な通話 ID  
*必須* – はい  
*デフォルト値* – なし

**Digits**  
説明 - `CallId` に対応する通話レッグで送信されるディジット  
使用できる値 – 0～9、\$1、\$1、A、B、C、D、カンマ (,)  
*必須* – はい  
*デフォルト値* – なし

**ToneDurationInMilliseconds**  
説明 - 各ディジットの送信で許容される時間 (ミリ秒単位)  
使用できる値 - 50～24000 の任意の整数  
*必須* – いいえ  
デフォルト値 – 250

## ACTION\$1SUCCESSFUL イベントの処理
<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 イベントの処理
<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/ja_jp/chime-sdk/latest/dg/images/send-digits-1.png)
