本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
VoiceFocus
可讓您在公用交換電話語音網路 (PSTN) 通話上將 Amazon 語音焦點雜訊抑制套用至入站和撥出電話。當您應用 Amazon 語音焦點時,它可以在不影響人類語音的情況下降低背景噪音。這樣可以使當前揚聲器更容易聽到。
若要建立輸入呼叫腿,您可以使用 SIP 規則來叫用具有NewInboundCall
事件的 AWS Lambda 函式。您可以使用CallAndBridge動作或使用 CreateSIPMediaApplicationCallAPI 作業來建立輸出呼叫支線。如需有關 Amazon 語音焦點的詳細資訊,請參閱 Amazon Chime 開發套件降噪的運作
Amazon 語音焦點可減少不必要的非語音噪音,包括:
環境噪音 — 風、風扇、自來水
背景噪音-割草機,吠叫的狗
前景噪音-打字,洗 paper
注意
當您使用 Amazon Voice Focus 時, AWS 會針對每個通話部分的使用中通話分鐘以及 SIP 媒體應用程式使用的每分鐘計費。
這個例子顯示了一個典型的VoiceFocus
動作。
{ "SchemaVersion": "1.0", "Actions":[ { "Type": "VoiceFocus", "Parameters": { "Enable":
True|False
, // required "CallId": "call-id-1
", // required } } ] }
- Enable
-
說明 — 啟用或停用 Amazon 語音焦點
允許的值 —
True
|False
必要 — 是
預設值 — 無
- CallId
-
說明 — CallId AWS Lambda 函數呼叫
CallDetails
的參與者允許的值 — 有效的呼叫 ID
必要 — 是
預設值 — 無
此範例顯示VoiceFocus
動作的成功ACTION_SUCCESSFUL
事件。
{ "SchemaVersion": "1.0", "Sequence": 3, "InvocationEventType": "ACTION_SUCCESSFUL", "ActionData": { "Type": "VoiceFocus", "Parameters": { "Enable":
True
, "CallId": "call-id-1
" } }, "CallDetails":{ ..... ..... "Participants":[ { "CallId": "call-id-of-caller
", ..... "Status": "Connected" }, { "CallId": "call-id-of-callee
", ..... "Status": "Connected" } ] } }
此範例顯示VoiceFocus
動作的典型ACTION_FAILED
事件。
{ "SchemaVersion": "1.0", "Sequence":2, "InvocationEventType": "ACTION_FAILED", "ActionData":{ "Type": "VoiceFocus", "Parameters": { "Enable":
True
, "CallId": "call-id-1
" } }, "ErrorType": "SystemException", "ErrorMessage": "System error while running action" }, "CallDetails":{ ..... ..... "Participants":[ { "CallId": "call-id-of-caller
", ..... } ] } }
錯誤處理
出於安全原因,PSTN 音頻操作的限制為每秒 5 個呼叫請求,每個客戶帳戶(CPS)。當呼叫要求超過 5 CPS 限制時,動作會傳回錯誤訊息。此表格列出VoiceFocus
動作傳回的錯誤訊息。
錯誤 | 訊息 | 原因 |
---|---|---|
|
無法執行動作。已達到每秒動作的最大數目。 | 每秒的語音焦點動作要求數目超出系統限制。 |
|
缺少必要的動作參數。 |
執行動作時遺失一或多個必要參數。 |
|
執行動作時發生系統錯誤。 |
執行動作時發生系統錯誤。 |
呼叫流程
此圖表顯示為兩個 PSTN 呼叫之間的CallAndBridge
動作啟用和停用 Amazon 語音焦點的呼叫流程。
![為兩個橋接的 PSTN 通話啟用或停用 Amazon 語音焦點時的呼叫流程。](images/voice_focus-pstn1.png)
對於撥出呼叫分段,此 AWS Lambda 功能可為來電者啟用 Amazon Voice 焦點,並傳回一組動作,包括CallAndBridge
。橋接呼叫之後,VoiceFocus
動作會傳回一個ACTION_SUCCESSFUL
事件,Lambda 函數會傳回另一組事件,以便為被呼叫的人啟用 Amazon 語音焦點。這組動作包括VoiceFocus
Enable
、True
、和呼叫者的 ID。在來電者掛斷之前,不會採取進一步的行動。Lambda 函數接著會將Hangup
動作傳送至 SIP 媒體應用程式。應用程式掛斷被呼叫的人員,並將掛斷函數傳送回 Lambda 函數,此函數不會採取進一步的動作。