本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 EventBridge 自動化 Amazon Chime 開發套件
Amazon EventBridge 可讓您自動化您的 AWS 服務,並自動回應系統事件,例如應用程式可用性問題或資源變更。如需會議事件的詳細資訊,請參閱《Amazon Chime SDK 開發人員指南》中的會議事件。
當 Amazon Chime SDK 產生事件時,會將其傳送至 EventBridge 以盡力交付,這表示 Amazon Chime SDK 會嘗試將所有事件傳送至 EventBridge,但在極少數情況下可能不會交付事件。如需詳細資訊,請參閱《Amazon EventBridge 使用者指南》中的來自 AWS 服務的事件。
注意
如果您需要加密資料,則必須使用 Amazon S3-Managed金鑰。我們不支援使用存放在 AWS Key Management Service 中的客戶主金鑰進行伺服器端加密。
使用 EventBridge 自動化 Amazon Chime SDK Voice Connector
Amazon Chime SDK Voice Connectors 可自動觸發的動作包括下列項目:
-
叫用 AWS Lambda 函數
-
啟動 Amazon Elastic Container Service 任務
-
將事件轉送至 Amazon Kinesis Video Streams
-
啟用 AWS Step Functions 狀態機器
-
通知 Amazon SNS 主題或 Amazon SQS 佇列
搭配 Amazon Chime SDK Voice Connectors 使用 EventBridge 的一些範例包括:
-
啟用 Lambda 函數,以在通話結束後下載通話的音訊。
-
啟動 Amazon ECS 任務,以在通話開始後啟用即時轉錄。
如需詳細資訊,請參閱「Amazon EventBridge 使用者指南」。
Amazon Chime SDK Voice Connector 串流事件
當本節討論的事件發生時,Amazon Chime SDK Voice Connectors 支援將事件傳送至 EventBridge。
Amazon Chime SDK Voice Connectors 會在媒體串流至 Kinesis Video Streams 時傳送此事件。
範例 事件資料
以下是此事件的範例資料。
{
"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
\" <sip:+12065550100
@10.24.34.0>;tag=abcdefg
",
"to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4M
.voiceconnector.chime.aws:5060>",
"call-id": "1112-2222-4333
",
"cseq": "101 INVITE",
"contact": "<sip:user@10.24.34.0:6090>;",
"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<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
"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"
}
}
當媒體串流至 Kinesis Video Streams 結束時,Amazon Chime SDK Voice Connectors 會傳送此事件。
範例 事件資料
以下是此事件的範例資料。
{
"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
\" <sip:+12065550100
@10.24.34.0>;tag=abcdefg
",
"to": "<sip:+13605550199
@abcdef1ghij2klmno3pqr4
.voiceconnector.chime.aws:5060>",
"call-id": "1112-2222-4333
",
"cseq": "101 INVITE",
"contact": "<sip:user@10.24.34.0:6090>",
"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<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
"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"
}
}
更新媒體串流至 Kinesis Video Streams 時,Amazon Chime SDK Voice Connectors 會傳送此事件。
範例 事件資料
以下是此事件的範例資料。
{
"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
\" <sip:+12065550100
@10.24.34.0>;;tag=abcdefg
",
"to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4
.voiceconnector.chime.aws:5060>",
"call-id": "1112-2222-4333
",
"cseq": "101 INVITE",
"contact": "<sip:user@10.24.34.0:6090>",
"content-type": "application/sdp",
"content-length": "246
"
},
"siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
"streamingStatus": "UPDATED",
"transactionId": "12345678-1234-1234
",
"version": "0",
"voiceConnectorId": "abcdef1ghij2klmno3pqr4
"
}
}
當媒體串流至 Kinesis Video Streams 失敗時,Amazon Chime SDK Voice Connectors 會傳送此事件。
範例 事件資料
以下是此事件的範例資料。
{
"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"
}
}