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

# Amazon Chime SDK PSTN オーディオサービスのテレフォニーイベントについて
<a name="pstn-invocations"></a>

Audio Service は、呼び出し中に特定のイベントが発生したときに AWS AWS Lambda 関数を呼び出します。次の例はイベントを示しています。それぞれのイベントについては、この例の後のテキストで説明しています。

```
{ 
    "SchemaVersion": "1.0", 
    "Sequence": 3, 
    "InvocationEventType": "event-type", 
    "CallDetails": { 
        "TransactionId": "transaction-id-1", 
        "AwsAccountId": "aws-acct-id-1", 
        "AwsRegion": "us-east-1", 
        "SipMediaApplicationId": "sip-media-app-id-1", 
        "Participants": [ 
            { 
                "CallId": "call-id-1", 
                "ParticipantTag": "LEG-A", 
                "To": "e164PhoneNumber", 
                "From": "e164PhoneNumber", 
                "Direction": "Inbound/Outbound", 
                "StartTimeInMilliseconds": "1641998241509", 
                "Status": "Connected/Disconnected" 
            } 
        ] 
    } 
}
```

**SchemaVersion**  
このイベントオブジェクトの作成に使用されたスキーマのバージョン。

**Sequence**  
 AWS Lambda 関数を呼び出すイベントのシーケンス。通話中に関数が呼び出されるたびに、シーケンスがインクリメントされます。

**InvocationEventType**  
 AWS Lambda 呼び出しをトリガーするイベントのタイプ。詳細については、このトピックで後述する「[イベントタイプ](#pstn-event-types)」を参照してください。

**CallDetails**  
 AWS Lambda 呼び出しに関連付けられた呼び出しに関する情報。

**TransactionId**  
 AWS Lambda 呼び出しに関連付けられた呼び出しの ID。

**AwsAccountId**  
通話ルーティングの原因となった SIP メディアアプリケーションに関連付けられた AWS アカウント ID。

**SipMediaApplicationId**  
通話に関連付けられた SIP メディアアプリケーションの ID。

**Participants**  
関数を呼び出す AWS AWS Lambda 呼び出しの参加者に関する情報。

**CallId**  
各参加者に割り当たられた一意の ID。

**ParticipantTag**  
各通話参加者にはタグ (`LEG-A` または `LEG-B`) が付けられます。

**To**  
参加者の「受信者」電話番号 (E.164 形式)。

**From**  
参加者の「発信者」電話番号 (E.164 形式)。

**Direction**  
通話レッグの発信元の方向。`Inbound` は Audio Service への通話を表します。`Outbound` は Audio Service からの通話を表します。

**StartTimeInMilliseconds**  
参加者が通話に参加したときから始まるエポック時間 (ミリ秒単位)。

**Status**  
参加者が `Connected` か `Disconnected` か。

## イベントタイプ
<a name="pstn-event-types"></a>

Audio Service は、以下のイベントタイプを使用して Lambda 関数を呼び出します。

**NEW\$1INBOUND\$1CALL**  
SIP メディアアプリケーションに関連付けられている電話番号から新しい通話が開始されました。

**NEW\$1OUTBOUND\$1CALL**  
[CreateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html) API を介して新しい発信通話が行われました。

**ACTION\$1SUCCESSFUL**  
 AWS Lambda 関数から返されたアクションは成功しました。成功したアクションには、成功したアクションと一致する `ActionData` が含まれます。  

```
    "ActionData": {
        // The previous successful action 
    },
```

**ACTION\$1FAILED**  
 AWS Lambda 関数から返されたアクションは成功しませんでした。失敗したアクションには、失敗したアクションと一致する `ActionData`、エラータイプ、失敗について説明するエラーメッセージが含まれます。  

```
    "ActionData": {
        // The previous unsuccessful action
        "ErrorType": "error-type",
        "ErrorMessage": "error message"
    },
```

**ACTION\$1INTERRUPTED**  
[UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html) API 通話によって、実行中のアクションが中断されました。`ActionData` には中断されたアクションが含まれます。  

```
"ActionData": {
        // The action that was interrupted
    },
```

**HANGUP**  
ユーザーまたはアプリケーションが通話レッグをハングアップしました。`ActionData` にはイベントに関する以下の詳細が含まれます。  

```
   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": 486,
            "CallId": "c70f341a-adde-4406-9dea-1e01d34d033d",
            "ParticipantTag": "LEG-A"
        }
    },
```  
**Type**  
Hangup  
**Parameters**  
`HANGUP` イベントに関する情報:   
+ **SipResponseCode** - イベントに関連付けられたレスポンスコード。最も一般的なコードは次のとおりです。
  + **0** - 通常のクリア
  + **480** - 応答なし
  + **486** - ユーザービジー
+ **CallId** ハングアップした参加者の ID。
+ **ParticipantTag** ハングアップした参加者のタグ。

**CALL\$1ANSWERED**  
Audio Service が応答し、着信通話が応答されました。このイベントは、通話がブリッジされない限り、ダイヤルアウト通話時に返されます。

**INVALID\$1LAMBDA\$1RESPONSE**  
最後の AWS Lambda 呼び出しに対して提供されたレスポンスが原因で問題が発生しました。`ActionData` には以下の追加フィールドが含まれます。  

```
    "ErrorType": "error-type-1", 
    "ErrorMessage": "error-msg-1"
```

**DIGITS\$1RECEIVED**  
アプリケーションは、`ReceiveDigits` アクションの完了後に DTMF ディジットを受け取りました。`ActionData` には受け取ったディジットが含まれます。  

```
    "ActionData": {
        "ReceivedDigits": ###
        // The ReceiveDigits action data
    },
```

**CALL\$1UPDATE\$1REQUESTED**  
[UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html) API が呼び出されました。`ActionData` には更新リクエストに関する情報が含まれます。  

```
    "ActionData": {
        "Type": "CallUpdateRequest", 
        "Parameters": {
            "Arguments": {
                "leg": "LEG-A"
                }
            }
        },
    }
```

**RINGING**  
通話レッグの呼び出し音が鳴っています。