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動作傳回的錯誤訊息。

錯誤	訊息	原因
ActionExecutionThrottled	無法執行動作。已達到每秒動作的最大數目。	每秒的語音焦點動作要求數目超出系統限制。
MissingRequiredActionParameter	缺少必要的動作參數。	執行動作時遺失一或多個必要參數。
SystemException	執行動作時發生系統錯誤。	執行動作時發生系統錯誤。

呼叫流程

此圖表顯示為兩個 PSTN 呼叫之間的CallAndBridge動作啟用和停用 Amazon 語音焦點的呼叫流程。

對於撥出呼叫分段，此 AWS Lambda 功能可為來電者啟用 Amazon Voice 焦點，並傳回一組動作，包括CallAndBridge。橋接呼叫之後，VoiceFocus動作會傳回一個ACTION_SUCCESSFUL事件，Lambda 函數會傳回另一組事件，以便為被呼叫的人啟用 Amazon 語音焦點。這組動作包括VoiceFocusEnable、True、和呼叫者的 ID。在來電者掛斷之前，不會採取進一步的行動。Lambda 函數接著會將Hangup動作傳送至 SIP 媒體應用程式。應用程式掛斷被呼叫的人員，並將掛斷函數傳送回 Lambda 函數，此函數不會採取進一步的動作。