翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# EventBridge を使用した Amazon Chime SDK の自動化
Amazon EventBridge を使用すると、 AWS サービスを自動化し、アプリケーションの可用性の問題やリソースの変更などのシステムイベントに自動的に対応できます。会議イベントの詳細については、*「Amazon Chime SDK デベロッパーガイド*」の[「会議イベント](https://docs.aws.amazon.com/chime/latest/dg/using-events.html)」を参照してください。
Amazon Chime SDK がイベントを生成すると、*ベストエフォート配信*のために EventBridge に送信されます。つまり、Amazon Chime SDK はすべてのイベントを EventBridge に送信しようとしますが、まれにイベントが配信されないことがあります。詳細については、*Amazon EventBridge ユーザーガイド*の「[AWS サービスからのイベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)」を参照してください。
**注記**
データを暗号化する必要がある場合、Amazon S3 マネージドキーを使用する必要があります。Key AWS Management Service に保存されているカスタマーマスターキーを使用したサーバー側の暗号化はサポートされていません。
## EventBridge を使用した Amazon Chime SDK Voice Connector の自動化
Amazon Chime SDK Voice Connector に対して自動的にトリガーできるアクションは次のとおりです。
+ AWS Lambda 関数の呼び出し
+ Amazon Elastic Container Service タスクの起動
+ Amazon Kinesis Video Streams へのイベントの中継
+ AWS Step Functions ステートマシンのアクティブ化
+ Amazon SNS トピックまたは Amazon SQS キューの通知
Amazon Chime SDK Voice Connector で EventBridge を使用する例には、次のようなものがあります。
+ 通話終了後に通話の音声をダウンロードする Lambda 関数を有効にします。
+ 通話の開始後に Amazon ECS タスクを起動してリアルタイム文字起こしを可能にする。
詳細については、[Amazon EventBridge ユーザーガイド](https://docs.aws.amazon.com/eventbridge/latest/userguide/)を参照してください。
## Amazon Chime SDK Voice Connector ストリーミングイベント
Amazon Chime SDK Voice Connector は、このセクションで説明するイベントが発生したときに EventBridge へのイベントの送信をサポートします。
### Amazon Chime SDK Voice Connector ストリーミングの開始
Amazon Chime SDK Voice Connector は、Kinesis Video Streams へのメディアストリーミングが開始されると、このイベントを送信します。
**Example イベントデータ**
以下はこのイベントのサンプルデータです。
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "Chime VoiceConnector Streaming Status",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"callId": "1112-2222-4333",
"direction": "Outbound",
"fromNumber": "+12065550100",
"inviteHeaders": {
"from": "\"John\" ;tag=abcdefg",
"to": "",
"call-id": "1112-2222-4333",
"cseq": "101 INVITE",
"contact": ";",
"content-type": "application/sdp",
"content-length": "246"
},
"isCaller": false,
"mediaType": "audio/L16",
"sdp": {
"mediaIndex": 0,
"mediaLabel": "1"
},
"siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n",
"startFragmentNumber": "1234567899444",
"startTime": "yyyy-mm-ddThh:mm:ssZ",
"streamArn": "arn:aws:kinesisvideo:us-east-1:123456M:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
"toNumber": "+13605550199",
"transactionId": "12345678-1234-1234",
"voiceConnectorId": "abcdef1ghij2klmno3pqr4",
"streamingStatus": "STARTED",
"version": "0"
}
}
```
### Amazon Chime SDK Voice Connector ストリーミングの終了
Amazon Chime SDK Voice Connector は、Kinesis Video Streams へのメディアストリーミングが終了すると、このイベントを送信します。
**Example イベントデータ**
以下はこのイベントのサンプルデータです。
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "Chime VoiceConnector Streaming Status",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"streamingStatus": "ENDED",
"voiceConnectorId": "abcdef1ghij2klmno3pqr4",
"transactionId": "12345678-1234-1234",
"callId": "1112-2222-4333",
"direction": "Inbound",
"fromNumber": "+12065550100",
"inviteHeaders": {
"from": "\"John\" ;tag=abcdefg",
"to": "",
"call-id": "1112-2222-4333",
"cseq": "101 INVITE",
"contact": "",
"content-type": "application/sdp",
"content-length": "246"
},
"isCaller": false,
"mediaType": "audio/L16",
"sdp": {
"mediaIndex": 0,
"mediaLabel": "1"
},
"siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n",
"startFragmentNumber": "1234567899444",
"startTime": "yyyy-mm-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ",
"streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
"toNumber": "+13605550199",
"version": "0"
}
}
```
### Amazon Chime SDK Voice Connector ストリーミングの更新
Amazon Chime SDK Voice Connector は、Kinesis Video Streams へのメディアストリーミングが更新されると、このイベントを送信します。
**Example イベントデータ**
以下はこのイベントのサンプルデータです。
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "Chime VoiceConnector Streaming Status",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"callId": "1112-2222-4333",
"updateHeaders": {
"from": "\"John\" ;;tag=abcdefg",
"to": "",
"call-id": "1112-2222-4333",
"cseq": "101 INVITE",
"contact": "",
"content-type": "application/sdp",
"content-length": "246"
},
"siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n",
"streamingStatus": "UPDATED",
"transactionId": "12345678-1234-1234",
"version": "0",
"voiceConnectorId": "abcdef1ghij2klmno3pqr4"
}
}
```
### Amazon Chime SDK Voice Connector ストリーミングが失敗する
Amazon Chime SDK Voice Connector は、Kinesis Video Streams へのメディアストリーミングが失敗した場合にこのイベントを送信します。
**Example イベントデータ**
以下はこのイベントのサンプルデータです。
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "Chime VoiceConnector Streaming Status",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"streamingStatus":"FAILED",
"voiceConnectorId":"abcdefghi",
"transactionId":"12345678-1234-1234",
"callId":"1112-2222-4333",
"direction":"Inbound",
"failTime":"yyyy-mm-ddThh:mm:ssZ",
"failureReason": "Internal failure",
"version":"0"
}
}
```