VoiceFocus

Vous permet d'appliquer la suppression du bruit d'Amazon Voice Focus aux tronçons d'appels entrants et sortants d'un appel sur un réseau téléphonique public commuté (PSTN). Lorsque vous appliquez Amazon Voice Focus, cela réduit le bruit de fond sans affecter le langage humain. Cela peut rendre l'orateur actuel plus facile à entendre.

Pour créer des segments d'appel entrants, vous utilisez une règle SIP qui invoque une AWS Lambda fonction associée à un NewInboundCall événement. Vous pouvez créer des segments d'appel sortants à l'aide de l'CallAndBridgeaction ou à l'aide d'une opération d'CreateSIPMediaApplicationCallAPI. Pour plus d'informations sur Amazon Voice Focus, consultez Comment fonctionne la suppression du bruit du SDK Amazon Chime.

Amazon Voice Focus réduit les bruits indésirables non liés à la parole, notamment :

• Bruits environnementaux : vent, ventilateurs, eau courante

• Bruits de fond : tondeuses à gazon, chiens qui aboient

• Bruits au premier plan : dactylographie, paper shuffling

Note

Lorsque vous utilisez Amazon Voice Focus, vous AWS facture les minutes d'appel actives de chaque segment d'appel et pour chaque minute d'utilisation de l'application multimédia SIP.

Cet exemple montre une VoiceFocus action typique.

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

Enable

Description — Active ou désactive Amazon Voice Focus

Valeurs autorisées — True | False

Obligatoire — Oui

Valeur par défaut – Aucune

CallId

Description — CallId du participant à l'CallDetailsinvocation de la AWS Lambda fonction

Valeurs autorisées : un identifiant d'appel valide

Obligatoire — Oui

Valeur par défaut – Aucune

Cet exemple montre un ACTION_SUCCESSFUL événement réussi pour l'VoiceFocusaction.

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

Cet exemple montre un ACTION_FAILED événement typique de l'VoiceFocusaction.

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

Gestion des erreurs

Pour des raisons de sécurité, les actions PSTN Audio sont limitées à 5 demandes d'appel par seconde, par compte client (CPS). Lorsque les demandes d'appel dépassent la limite de 5 CPS, l'action renvoie un message d'erreur. Ce tableau répertorie les messages d'erreur renvoyés par l'VoiceFocusaction.

Erreur	Message	Raison
ActionExecutionThrottled	Impossible d'exécuter l'action. Le nombre maximum d'actions par seconde a été atteint.	Le nombre de demandes d'action Voice Focus par seconde a dépassé la limite du système.
MissingRequiredActionParameter	Paramètre d'action obligatoire manquant.	Il manque un ou plusieurs des paramètres requis lors de l'exécution de l'action.
SystemException	Erreur système lors de l'exécution de l'action.	Une erreur système s'est produite lors de l'exécution de l'action.

Flux d'appels

Ce schéma montre le flux d'appels permettant d'activer et de désactiver Amazon Voice Focus pour une CallAndBridge action entre deux appels PSTN.

Pour le segment des appels sortants, la AWS Lambda fonction permet à Amazon Voice de se concentrer sur l'appelant et renvoie un ensemble d'actions, notamment. CallAndBridge Une fois l'appel transféré, l'VoiceFocusaction renvoie un ACTION_SUCCESSFUL événement, et la fonction Lambda renvoie un autre ensemble d'événements qui active Amazon Voice Focus pour la personne appelée. Cet ensemble d'actions inclutVoiceFocus, EnableTrue, et l'identifiant de l'appelant. Aucune autre action n'est entreprise tant que l'appelant n'a pas raccroché. La fonction Lambda envoie ensuite une Hangup action à l'application multimédia SIP. L'application raccroche la personne appelée et renvoie une fonction de blocage à la fonction Lambda, qui n'effectue aucune autre action.