VoiceFocus

Ermöglicht es Ihnen, Amazon Voice Focus-Geräuschunterdrückung auf eingehende und ausgehende Anrufe in einem öffentlichen Telefonnetz (PSTN) anzuwenden. Wenn Sie Amazon Voice Focus anwenden, werden Hintergrundgeräusche reduziert, ohne die menschliche Sprache zu beeinträchtigen. Dadurch kann der aktuelle Lautsprecher leichter zu hören sein.

Um Abschnitte für eingehende Anrufe zu erstellen, verwenden Sie eineSIP-Regeldas ruft eineAWS LambdaFunktion mit einemNewInboundCallEreignis. Sie können Abschnitte für ausgehende Anrufe erstellen, indem Sie denCallAndBridgeAktion, oder durch Verwendung einerSIP erstellenMediaApplicationCallAPI-Betrieb. Weitere Informationen zu Amazon Voice Focus finden Sie unterSo funktioniert die Geräuschunterdrückung des Amazon Chime SDK.

Amazon Voice Focus reduziert unerwünschte Geräusche, die nichts mit Sprache zu tun haben, darunter:

• Umgebungsgeräusche—Wind, Ventilatoren, fließendes Wasser

• Hintergrundgeräusche— Rasenmäher, bellende Hunde

• Vordergrundgeräusche—tippen, Papier mischen

Anmerkung

Wenn Sie Amazon Voice Focus verwenden,AWSstellt Ihnen die aktiven Gesprächsminuten jeder Verbindungsstrecke und für jede Minute der Nutzung von SIP-Medienanwendungen in Rechnung.

Dieses Beispiel zeigt ein typischesVoiceFocusAktion.

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

Aktivieren

Beschreibung— Aktiviert oder deaktiviert Amazon Voice Focus

Zulässige Werte—True|False

Erforderlich— Ja

Standardwert – Kein

CallId

Beschreibung—CallIddes Teilnehmers an derCallDetailsdesAWS LambdaFunktionsaufruf

Zulässige Werte— Eine gültige Anruf-ID

Erforderlich— Ja

Standardwert – Kein

Dieses Beispiel zeigt eine erfolgreicheACTION_SUCCESSFULVeranstaltung für dieVoiceFocusAktion.

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

Dieses Beispiel zeigt ein typischesACTION_FAILEDVeranstaltung für dieVoiceFocusAktion.

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

Fehlerbehandlung

Aus Sicherheitsgründen sind die PSTN-Audioaktionen auf 5 Anrufanfragen pro Sekunde pro Kundenkonto (CPS) begrenzt. Wenn Anrufanforderungen das Limit von 5 CPS überschreiten, gibt die Aktion eine Fehlermeldung zurück. In dieser Tabelle sind die Fehlermeldungen aufgeführt, die von derVoiceFocusAktion.

Fehler	Fehlermeldung	Grund
ActionExecutionThrottled	Aktion konnte nicht ausgeführt werden. Die maximale Anzahl von Aktionen pro Sekunde wurde erreicht.	Die Anzahl der Voice Focus-Aktionsanfragen pro Sekunde hat das Systemlimit überschritten.
MissingRequiredActionParameter	Fehlender erforderlicher Aktionsparameter.	Beim Ausführen der Aktion fehlen einer oder mehrere der erforderlichen Parameter.
SystemException	Systemfehler beim Ausführen der Aktion.	Beim Ausführen der Aktion ist ein Systemfehler aufgetreten.

Anrufflüsse

Dieses Diagramm zeigt den Anrufablauf für die Aktivierung und Deaktivierung von Amazon Voice Focus fürCallAndBridgeAktion zwischen zwei PSTN-Aufrufen.