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.
# Mise en place du streaming en direct de l’audio des clients dans Amazon Connect
Dans Amazon Connect, vous pouvez capturer l'audio client au cours d'une interaction avec votre centre de contact en envoyant l'audio à un flux vidéo Kinesis. Selon vos paramètres, le son peut être capturé pendant toute l'interaction, jusqu'à ce que l'interaction avec l'agent soit terminée, ou dans une seule direction :
+ Ce que le client entend, y compris ce que dit l'agent et les invites système.
+ Ce que le client dit, y compris lorsqu'il est en attente.
Les flux audio du client incluent également les interactions avec un bot Amazon Lex, si vous en utilisez un dans votre flux.
**Topics**
+ [Planification du streaming multimédia en direct](plan-live-media-streams.md)
+ [Activer le streaming multimédia en direct](enable-live-media-streams.md)
+ [Accéder aux données Kinesis Video Streams](access-media-stream-data.md)
+ [Test de streaming multimédia en direct](use-media-streams-blocks.md)
+ [Attributs de contact pour le streaming multimédia en direct](media-streaming-attributes.md)
# Planification du streaming multimédia en direct depuis Amazon Connect vers Kinesis Video Streams
**Important**
Si vous souhaitez utiliser la fonctionnalité de streaming audio, vous devez conserver les flux créés par Amazon Connect. Ne les supprimez pas, sauf si vous allez cesser d'utiliser la fonction de diffusion en continu.
Vous pouvez envoyer tout le contenu audio vers le client et à partir du client vers Kinesis Video Streams. Le streaming multimédia tire parti de la prise en charge multipiste Kinesis Video Streams pour que ce que le client dit soit sur une piste distincte de ce que le client entend.
L'audio envoyé à Kinesis utilise un taux d'échantillonnage de 8 kHz.
## Avez-vous besoin d'augmenter vos quotas de service ?
Lorsque vous activez le streaming multimédia dans Amazon Connect, un flux vidéo Kinesis est utilisé par appel actif. Nous créons des flux KVS selon les besoins pour gérer les demandes de streaming simultanées. Nous créons automatiquement des flux supplémentaires selon les besoins, pour suivre le rythme des appels actifs, à moins que votre compte n'atteigne le [quota du service Kinesis Video Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html).
Contactez-nous Support pour demander une augmentation **du nombre de streams**.
Pour demander une augmentation de votre quota de service, dans le Centre de AWS support, choisissez **Create Case**, puis choisissez **Service Quota Increase**.
**Astuce**
Nous veillons à ce que les **PutMedia**demandes respectent toujours le quota de 5 TPS. Vous n'avez pas besoin de demander une augmentation.
## Pendant combien de temps devez-vous stocker l'audio ?
L'audio du client est stocké dans Kinesis le temps défini par vos paramètres de conservation dans une instance Amazon Connect. Pour obtenir des instructions sur la définition de cette valeur, consultez [Activation du streaming multimédia en direct dans votre instance Amazon Connect](enable-live-media-streams.md).
## Avez-vous besoin de changer les flux audio ?
Nous vous recommandons de ne pas modifier les flux. Cela peut entraîner un comportement inattendu.
## Qui requiert des autorisations IAM pour récupérer des données ?
Si votre entreprise utilise des autorisations IAM, votre AWS administrateur devra accorder des autorisations aux rôles IAM qui doivent récupérer des données depuis Kinesis Video Streams. Il doit leur accorder des autorisations d’accès complet pour Kinesis Video Streams et AWS Key Management Service.
# Activation du streaming multimédia en direct dans votre instance Amazon Connect
Le streaming multimédia en direct (flux audio du client) n'est pas activé par défaut. Vous pouvez activer les flux audio du client à partir de la page des paramètres de votre instance.
**Pour activer le streaming multimédia en direct**
1. Ouvrez la console Amazon Connect à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Dans la page Instances, choisissez l’alias d’instance. L’alias d’instance est également le **nom de votre instance**, qui apparaît dans votre URL Amazon Connect. L'image suivante présente la page **Instances du centre de contact virtuel Amazon Connect** avec un encadré autour de l'alias d'instance.
1. Dans le panneau de navigation, choisissez **Stockage de données**.
1. Sous **Live media streaming (Streaming multimédia en direct)**, choisissez **Modifier**. Choisissez **Enable live media streaming (Activer le streaming multimédia en direct)**.
1. Saisissez un préfixe pour le Kinesis Video Streams créé pour l'audio de votre client. Ce préfixe vous permet d'identifier le flux avec les données.
1. Les données sont chiffrées avant leur écriture sur la couche de stockage du flux Kinesis Video Streams et déchiffrées après leur extraction de l’espace de stockage. Par conséquent, vos données sont toujours chiffrées au repos dans le service Kinesis Data Streams. Choisissez la clé KMS utilisée pour chiffrer les données dans Kinesis Video Streams, comme illustré dans l’image suivante.
![\[Section Chiffrement dans laquelle vous choisissez la clé KMS.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/streaming-encryption.png)
Lorsque vous choisissez d’entrer votre propre clé, tenez compte des restrictions suivantes :
1. La clé KMS doit exister dans la même région que l'instance.
1. La clé KMS doit être soit :
+ Une clé gérée par le client
OU
+ La clé AWS gérée pour Kinesis Video Streams (aws/kinesisvideo).
Il ne doit pas s'agir d'une des clés AWS gérées automatiquement créées pour d'autres services (par exemple,aws/connect, aws/lambda, aws/kinesis).
1. L’autorisation octroyée pour la clé par Amazon Connect ne doit pas être révoquée. Ces autorisations octroyées auraient le format `GranteePrincipal` suivant :
```
arn:aws:iam::customer-account-id:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hash_suffix
```
1. Spécifiez un nombre et une unité pour la **Durée de conservation**.
**Important**
Si vous sélectionnez **Aucune conservation des données**, les données ne sont pas conservées et ne peuvent être consommées que pendant 5 minutes. Il s'agit de la durée minimale par défaut pendant laquelle Kinesis conserve les données.
Comme Amazon Connect utilise Kinesis pour le streaming, les [quotas Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) s’appliquent.
1. Choisissez **Enregistrer** sous **Live media streaming (Streaming multimédia en direct)**, puis **Enregistrer** en bas de la page.
Après avoir activé le streaming multimédia en direct, ajoutez les blocs **Démarrer le streaming multimédia** et **Arrêter le streaming multimédia** dans votre flux. Configurez ces blocs pour spécifier l'audio que vous souhaitez capturer. Pour obtenir plus d'informations et un exemple, reportez-vous à la section [Exemple de flux de contacts pour tester le streaming multimédia en direct dans Amazon Connect](use-media-streams-blocks.md).
# Développement du streaming multimédia en direct dans Amazon Connect
Pour vous aider à vous lancer dans le développement à l'aide du streaming multimédia en direct, Amazon Connect inclut le référentiel Kinesis Video Streams suivant, qui contient un exemple de base expliquant comment utiliser les données audio de vos Kinesis Video Streams : [https://github.com/amazon-connect/connect-kvs-consumer-demo](https://github.com/amazon-connect/connect-kvs-consumer-demo)
Cette démonstration s’appuie sur les abstractions de haut niveau fournies par la bibliothèque d’analyseurs Kinesis Video Streams pour lire les pistes `AUDIO_TO_CUSTOMER` et `AUDIO_FROM_CUSTOMER` publiées par Amazon Connect. Elle stocke ces données sous forme de fichier PCM brut. Ce fichier peut être transformé, transcodé ou lu.
# Exemple de flux de contacts pour tester le streaming multimédia en direct dans Amazon Connect
Configuration possible d'un flux pour tester le streaming multimédia en direct :
1. Ajoutez un bloc **Start media streaming (Démarrer le streaming multimédia)** au point où vous souhaitez activer le streaming audio du client.
1. Connectez la branche **Réussite** au reste de votre flux.
1. Ajoutez un bloc **Stop media streaming (Arrêter le streaming multimédia)** à l'endroit où vous souhaitez arrêter le streaming.
1. Configurez les deux blocs pour spécifier ce que vous souhaitez diffuser : **Du client and/or ** **au client**.
![\[Un bloc de démarrage pour le streaming multimédia.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/start-media-streaming.png)
L'audio du client est capturé jusqu'à l'invocation d'un bloc **Arrêter la diffusion de contenu**, même si le contact a été transféré à un autre flux.
Utilisez les attributs de contact pour le streaming de médias dans votre flux afin que l'enregistrement de contacts inclue les attributs. Vous pouvez ensuite consulter l'enregistrement de contacts pour déterminer les données de streaming multimédia associées à un contact spécifique. Vous pouvez également transmettre les attributs à une AWS Lambda fonction.
L'exemple de flux suivant montre comment vous pouvez utiliser le streaming multimédia avec des attributs à des fins de test. Ce flux inclut un bloc **Démarrer le streaming multimédia**, mais il manque le bloc **Arrêter le streaming multimédia**.
![\[Un flux d'exemple avec un bloc de démarrage du streaming multimédia.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/media-streaming-flow.png)
Une fois que le son est correctement diffusé sur Kinesis Video Streams, les attributs de contact sont renseignés à partir du bloc de fonction **Invoke AWS Lambda**. Vous pouvez utiliser les attributs pour identifier l'emplacement dans le flux où l'audio du client démarre. Pour obtenir des instructions, consultez [Attributs de contact pour le streaming multimédia en direct dans Kinesis Video Streams](media-streaming-attributes.md).
# Attributs de contact pour le streaming multimédia en direct dans Kinesis Video Streams
Les attributs s'affichent lorsque vous sélectionnez **Flux de médias** pour le **Type** dans un bloc de flux prenant en charge les attributs, tels que le bloc **Démarrer le streaming de médias**. Il s'agit notamment des paramètres suivants :
ARN de flux audio du client
ARN du flux vidéo Kinesis qui inclut les données client à référencer.
**JSONPath format :** \$1. MediaStreams.Client.Audio.StreamArn
Horodatage de démarrage audio du client
Heure de début du flux audio du client.
**JSONPath format :** \$1. MediaStreams.Client.Audio. StartTimestamp
Horodatage d'arrêt audio du client
Heure d'arrêt du flux audio du client.
**JSONPath format :** \$1. MediaStreams.Client.Audio. StopTimestamp
Numéro du fragment du début de l'audio du client
Nombre qui identifie le fragment de flux vidéo Kinesis dans lequel le flux audio du client a démarré.
**JSONPath format :** \$1. MediaStreams.Client.Audio. StartFragmentNumber
Pour plus d'informations sur les fragments Amazon Kinesis Video Streams, consultez [Fragment](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html) dans le *Guide du développeur Amazon Kinesis Video Streams*.