本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
若要建立外撥通話,您可以使用 CreateSipMediaApplicationCall API。會API叫用指定 的端點SIP media application ID
。客戶可以提供不同的訊號來控制通話流程,並 SipMediaApplication 來自端點的動作。
如果回應成功, API會傳回 202 http 狀態碼和 transactionId,您可以搭配 使用 UpdateSipMediaApplicationCall API 更新進行中呼叫。
下圖顯示對傳出呼叫的 AWS Lambda 函數端點發出的叫用。
針對SIP媒體應用程式設定的端點會針對撥出呼叫的不同狀態叫用。當客戶起始呼叫時,Amazon Chime 會使用NEW_OUTBOUND_CALL
叫用事件類型SDK叫用端點。
此範例顯示 的典型叫用事件NEW_OUTBOUND_CALL
。
{
"SchemaVersion": "1.0",
"Sequence": 1,
"InvocationEventType": "NEW_OUTBOUND_CALL",
"CallDetails": {
"TransactionId": "transaction-id
",
"AwsAccountId": "aws-account-id
",
"AwsRegion": "us-east-1",
"SipApplicationId": "sip-application-id
",
"Participants": [
{
"CallId": "call-id-1
",
"ParticipantTag": "LEG-A",
"To": "+1xxxx
",
"From": "+1xxxxxxx
",
"Direction": "Outbound",
"StartTimeInMilliseconds": "159700958834234
"
}
]
}
}
會忽略事件相關 AWS Lambda 調用的任何回應。
當我們收到來自接收者的RINGING
通知時,Amazon Chime 會再次SDK叫用設定的端點。
此範例顯示 的典型叫用事件RINGING
。
{
"SchemaVersion": "1.0",
"Sequence": 1,
"InvocationEventType": "RINGING",
"CallDetails": {
"TransactionId": "transaction-id
",
"AwsAccountId": "aws-account-id
",
"AwsRegion": "us-east-1",
"SipApplicationId": "sip-application-id
",
"Participants": [
{
"CallId": "call-id-1
",
"ParticipantTag": "LEG-A",
"To": "+1xxxx
",
"From": "+1xxxxxxx
",
"Direction": "Outbound",
"StartTimeInMilliseconds": "159700958834234
"
}
]
}
}
會忽略事件相關 AWS Lambda 調用的任何回應。
如果接聽者未接聽通話,或通話因錯誤而失敗,Chime 會中斷通話,並叫用Hangup
事件類型的端點。如需Hangup
事件類型的詳細資訊,請參閱 結束通話。
如果呼叫已接聽,Chime 會使用 CALL_ANSWERED
動作叫用端點。此範例顯示典型的叫用事件。
{
"SchemaVersion": "1.0",
"Sequence": 1,
"InvocationEventType": "CALL_ANSWERED",
"CallDetails": {
""TransactionId": "transaction-id
",
"AwsAccountId": "aws-account-id
",
"AwsRegion": "us-east-1",
"SipApplicationId": "sip-application-id
",
"Participants": [
{
"CallId": "call-id-1
",
"ParticipantTag": "LEG-A",
"To": "+1xxxx
",
"From": "+1xxxxxxx
",
"Direction": "Outbound",
"StartTimeInMilliseconds": "159700958834234
",
"Status": "Connected"
}
]
}
}
此時,您可以使用動作清單回應調用,以傳回動作。如果您不想執行任何動作,請使用空清單回應。您每次調 AWS Lambda 用最多可以回應 10 個動作,而且每次呼叫可以叫用 Lambda 函數 1,000 次。如需使用一組動作回應的詳細資訊,請參閱 使用動作清單回應調用。