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 du service audio PTSN du SDK Amazon Chime
<a name="voice-focus"></a>

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](https://docs.aws.amazon.com/chime/latest/ag/manage-sip-applications.html) 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'[CallAndBridge](call-and-bridge.md)action ou à l'aide d'une opération d'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateSipMediaApplicationCall.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateSipMediaApplicationCall.html)API. Pour plus d'informations sur Amazon Voice Focus, consultez [Comment fonctionne la suppression du bruit du SDK Amazon Chime](https://www.amazon.science/blog/how-amazon-chimes-challenge-winning-noise-cancellation-works).

 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'`CallDetails`invocation 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'`VoiceFocus`action.

```
{
   "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'`VoiceFocus`action.

```
{
   "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'`VoiceFocus`action.


| 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.](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/voice_focus-pstn1.png)


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'`VoiceFocus`action 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 inclut`VoiceFocus`, `Enable``True`, 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.