了解電話語音事件 - Amazon Chime SDK
事件類型

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

了解電話語音事件

當調用期間發生某些事件時，音頻服務調用您的 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 呼叫的事件類型。如需詳細資訊，請參閱本主題後面部分的 事件類型。

CallDetails

與呼叫相關聯之呼 AWS Lambda 叫的相關資訊。

TransactionId

與呼叫相關聯的呼 AWS Lambda 叫識別碼。

AwsAccountId

與導致呼叫路由之 SIP 媒體應用程式相關聯的 AWS 帳戶 ID。

SipMediaApplicationId

與呼叫相關聯之 SIP 媒體應用程式的識別碼。

Participants

呼叫 AWS AWS Lambda 函數之呼叫參與者的相關資訊。

CallId

指派給每個參與者的唯一 ID。

ParticipantTag

每個通話參與者都會獲得一個標籤，LEG-A或LEG-B。

To

參加者的「收件人」電話號碼，以 E.164 格式顯示。

From

參與者「寄件者」電話號碼，以 E.164 格式顯示。

Direction

呼叫腿來自的方向。 Inbound代表對音訊服務進行的呼叫。 Outbound代表從音訊服務進行的呼叫。

StartTimeInMilliseconds

紀元時間 (以毫秒為單位)，從參與者加入通話時開始。

Status

參與者是否為Connected或 Disconnected

事件類型

音訊服務會使用下列事件類型叫用 Lambda 函數：

NEW_INBOUND_CALL

與您的 SIP 媒體應用程式相關聯的電話號碼已啟動新通話。

NEW_OUTBOUND_CALL

通過 CreateSipMediaApplicationCallAPI 進行了新的呼出呼叫。

ACTION_SUCCESSFUL

從 AWS Lambda 函數傳回的動作已成功。成功的處理行動ActionData包括符合成功動作的動作。


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

從 AWS Lambda 函數傳回的動作未成功。不成功ActionData的處理行動包括符合失敗的處理行動、錯誤類型，以及描述失敗的錯誤訊息：


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

執行程序中的動作被 UpdateSipMediaApplicationCallAPI 叫用中斷。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

掛斷。

Parameters

有關HANGUP事件的信息：

  • SipResponseCode— 與事件相關聯的回應碼。最常見的代碼是：

    • 0 — 正常清除

    • 480 — 沒有答案

    • 486 — 使用者忙碌

  • CallId掛斷的參加者的 ID。

  • ParticipantTag掛斷的參與者的標籤。

CALL_ANSWERED

音頻服務接聽了來電。除非已橋接呼叫，否則此事件會在撥出呼叫時傳回。

INVALID_LAMBDA_RESPONSE

提供給上次 AWS Lambda 調用的響應導致了問題。ActionData包括下列其他欄位：


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

應用程序在操作ReceiveDigits完成後收到 DTMF 數字。包ActionData括接收到的數字。


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

該 UpdateSipMediaApplicationCallAPI 已被調用。包ActionData括更新要求的相關資訊：


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

A, 呼叫, 腿, 是, 鈴聲