使用自動化 Amazon Chime 開發套件 EventBridge - Amazon Chime SDK
使用自動執行 Amazon Chime SDK 語音連接器 EventBridgeAmazon Chime 聲 SDK 語音連接器串流事件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用自動化 Amazon Chime 開發套件 EventBridge

Amazon EventBridge 可讓您自動化 AWS 服務並自動回應系統事件，例如應用程式可用性問題或資源變更。如需會議事件的詳細資訊，請參閱 Amazon Chime SDK 開發人員指南中的會議事件。

Amazon Chime 開發套件產生事件時，會將事件傳送到 EventBridge 以盡最大努力交付，這表示 Amazon Chime SDK 會嘗試將所有事件傳送至 EventBridge，但在極少數情況下可能無法傳遞事件。如需詳細資訊，請參閱 Amazon EventBridge 使用者指南中的來自 AWS 服務的事件。

注意

如果您需要加密資料，則必須使用 Amazon S3 受管金鑰。我們不支援使用儲存在金鑰管理服務中的客戶主金鑰進行 AWS 伺服器端加密。

使用自動執行 Amazon Chime SDK 語音連接器 EventBridge

可針對 Amazon Chime SDK 語音連接器自動觸發的動作包括：

  • 調用函數 AWS Lambda

  • 啟動 Amazon 彈性容器服務任務

  • 將事件轉送至 Amazon Kinesis Video Streams

  • 啟動 AWS Step Functions 狀態機

  • 通知 Amazon SNS 主題或 Amazon SQS 佇列

EventBridge 搭配 Amazon Chime SDK 語音連接器使用的一些範例包括：

  • 啟用 Lambda 函數以在通話結束後下載通話的音訊。

  • 啟動 Amazon ECS 任務以在呼叫開始後啟用即時轉錄。

如需詳細資訊，請參閱 Amazon EventBridge 使用者指南。

Amazon Chime 聲 SDK 語音連接器串流事件

Amazon Chime SDK 語音連接器支援將事件傳送至本節中討論的事件發生 EventBridge 時。

Amazon Chime SDK 語音連接器會在媒體串流至 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"
    }
}

Amazon Chime SDK 語音連接器會在媒體串流至 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": {
        "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"
    }
}

Amazon Chime SDK 語音連接器會在媒體串流至 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",
        "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"
    }
}

Amazon Chime SDK 語音連接器會在媒體串流至 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": {
       "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"
  }
}