VoiceFocus

Consente di applicare la soppressione del rumore di Amazon Voice Focus alle chiamate in entrata e in uscita su una rete telefonica pubblica a commutazione (PSTN). Quando applichi Amazon Voice Focus, riduce il rumore di fondo senza influire sul linguaggio umano. Questo può rendere l'altoparlante attuale più facile da ascoltare.

Per creare intervalli di chiamata in entrata, si utilizza unRegola SIPche richiama unAWS Lambdafunzione con unNewInboundCallevento. È possibile creare intervalli di chiamata in uscita utilizzandoCallAndBridgeazione, o utilizzando unCrea SIPMediaApplicationCallFunzionamento dell'API. Per ulteriori informazioni su Amazon Voice Focus, consultaCome funziona la cancellazione del rumore di Amazon Chime SDK.

Amazon Voice Focus riduce i rumori non vocali indesiderati, tra cui:

• Rumori ambientali—vento, ventilatori, acqua corrente

• Rumori di sottofondo— tosaerba, cani che abbaiano

• Rumori in primo piano—digitazione, rimescolamento della carta

Nota

Quando usi Amazon Voice Focus,AWSfattura all'utente i minuti di chiamata attivi di ogni tratta di chiamata e per ogni minuto di utilizzo dell'applicazione multimediale SIP.

Questo esempio mostra un tipicoVoiceFocusazione.

{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "VoiceFocus",
            "Parameters": {
                "Enable": True|False,            // required
                "CallId": "call-id-1",           // required    
            }
        }
    ]
}

Attiva

Descrizione— Attiva o disattiva Amazon Voice Focus

Valori consentiti—True|False

Richiesto— Sì

Valore predefinito - nessuno

CallId

Descrizione—CallIddel partecipante alCallDetailsdelAWS Lambdainvocazione di una funzione

Valori consentiti— Un ID di chiamata valido

Richiesto— Sì

Valore predefinito - nessuno

Questo esempio mostra un successoACTION_SUCCESSFULevento per ilVoiceFocusazione.

{
   "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"
         }
      ]
   }
}

Questo esempio mostra un tipicoACTION_FAILEDevento per ilVoiceFocusazione.

{
   "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",
            .....   
         }
      ]
   }
}

Gestione degli errori

Per motivi di sicurezza, le azioni PSTN Audio hanno un limite di 5 richieste di chiamata al secondo, per account cliente (CPS). Quando le richieste di chiamata superano il limite di 5 CPS, l'azione restituisce un messaggio di errore. Questa tabella elenca i messaggi di errore restituiti daVoiceFocusazione.

Errore	Message	Motivo
ActionExecutionThrottled	Esecuzione dell'azione non riuscita. È stato raggiunto il numero massimo di azioni al secondo.	Il numero di richieste di azioni di Voice Focus al secondo ha superato il limite di sistema.
MissingRequiredActionParameter	Parametro di azione richiesto mancante.	Mancano uno o più parametri richiesti durante l'esecuzione dell'azione.
SystemException	Errore di sistema durante l'esecuzione dell'azione.	Si è verificato un errore di sistema durante l'esecuzione dell'azione.

Flussi di chiamate

Questo diagramma mostra il flusso di chiamate per abilitare e disabilitare Amazon Voice Focus per unCallAndBridgeazione tra due chiamate PSTN.