Compréhension VoiceFocus pour le service audio PTSN du SDK Amazon Chime - Kit SDK Amazon Chime

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Compréhension VoiceFocus pour le service audio PTSN du SDK Amazon Chime

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 en utilisant l'CallAndBridgeaction ou en utilisant un CreateSIPMediaApplicationCallFonctionnement de l'API. 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 audio PSTN 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.

Le flux d'appels lorsque vous activez ou désactivez Amazon Voice focus pour deux appels PSTN pontés.

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 que l'appel est ponté, 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.