

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.

# Création de pipelines de flux multimédia dans le SDK Amazon Chime
<a name="create-stream-pipeline"></a>

Le pipeline de flux multimédia Chime doit appartenir au même AWS compte que la réunion du SDK Amazon Chime. Vous créez le pipeline de flux multimédia du SDK Amazon Chime en appelant l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API et en spécifiant une source et un récepteur.

Le schéma suivant montre l'architecture d'un pipeline de flux multimédia du SDK Amazon Chime. Les chiffres du schéma correspondent au texte numéroté ci-dessous.

![\[Schéma illustrant un appel d'API qui crée un pool de flux multimédia.\]](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


Dans le schéma :

1. Vous appelez l'`CreateMediaStreamPipeline`API. Dans la demande, spécifiez les sources et les récepteurs des flux, que vous souhaitiez capturer un son individuel, un son mixte ou les deux. Incluez l'ARN de votre pool KVS dans la demande.
   + Le tableau des sources se compose des éléments `SourceType` et`SourceArn`. Vous devez utiliser le`ChimeSdkMeeting SourceType`. `SourceArn`Il s'agit de l'ARN du`ChimeSdkMeeting`.
   + Le réseau de récepteurs comprend les éléments `SinkType``SinkArn`,`ReservedStreamCapacity`, et`MediaStreamType`. Nous soutenons uniquement le`KinesisVideoStreamPoolSinkType`. `SinkArn`Il s'agit de l'ARN du`KinesisVideoStreamPool`. Le `MediaStreamType` contrôle le type de média diffusé vers le récepteur, `MixedAudio` soit`IndividualAudio`. `ReservedStreamCapacity`définit le nombre de flux alloués pour le `MediaStreamType``KinesisVideoStreamPool`.
     + Si vous souhaitez diffuser `IndividualAudio` les deux`MixedAudio`, créez deux objets récepteurs dans le `Sinks` tableau, l'un pour`IndividualAudio`, l'autre pour`MixedAudio`. L'`SinkArn`(l'ARN du`KinesisVideoStreamPool`) peut varier pour chaque récepteur.
     + Pour diffuser uniquement du son individuel ou du son mixte, créez un objet récepteur avec l'objet souhaité`MediaStreamType`.
   + Notez ce qui suit :
     + Lorsque vous appelez l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API en `KinesisVideoStreamPool` tant que`SinkType`, elle `SinkARN` doit appartenir à la région du plan de contrôle dans laquelle elle `CreateMediaStreamPipeline` est invoquée.

       Par exemple, si vous créez un pipeline de flux multimédia dans`us-east-1`, vous devez utiliser un `KinesisVideoStreamPool` in`us-east-1`.
     + `ReservedStreamCapacity`devrait être **1** lorsque vous spécifiez le `MixedAudio``MediaStreamType`, et entre les deux **1-10** lorsque vous spécifiez le `IndividualAudio``MediaStreamType`.

1. Le plan de données du pipeline multimédia appelle l'[ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)API KVS pour stocker le son individuel dans un flux KVS appartenant au pool KVS que vous spécifiez.

1. Le plan de données du pipeline multimédia appelle l'`PutMedia`API KVS pour stocker le son mixé dans un flux appartenant au pool KVS que vous spécifiez.

**Note**  
Après avoir appelé l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API, les créateurs peuvent utiliser [les événements du pipeline multimédia](media-pipe-events.md) ou appeler l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html)API pour déterminer si l'état du pipeline est le cas`InProgress`.  
Une fois que l'état du pipeline est atteint`InProgress`, le média (n'importe quelle combinaison de `IndividualAudio` et) est diffusé vers le `MixedAudio` KVS.   
Pour le type de `IndividualAudio` flux, un mappage 1:1 existe entre le participant IDs et le flux KVS alloué depuis le. `KinesisVideoStreamPool` Le mappage s'applique pendant toute la durée de vie du pipeline multimédia.  
Pour savoir quel flux KVS correspond à un identifiant de participant ou auquel il est attribué MixedAudio, utilisez l'une des techniques suivantes :  
Utilisez les [notifications Event Bridge](media-stream-event-bridge.md). Chaque notification fournit des informations telles que le participant IDs et l'ARN KVS qui diffuse le son du participant. Lorsqu'une `IndividualAudio` session de `MixedAudio` streaming démarre, nous envoyons un `chime:MediaPipelineKinesisVideoStreamStart` événement. Les sessions de streaming se terminent lorsqu'un participant quitte l'appel (pour`IndividualAudio`) ou à la fin de la réunion.
Utilisez les métadonnées persistantes que les Kinesis Video Streams envoient avec chaque fragment. Les métadonnées contiennent des informations similaires à celles envoyées par Event Bridge. Les créateurs doivent analyser tous les flux du `KinesisVideoStreamPool` en spécifiant le nom du pool comme préfixe dans l'API [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)Kinesis Video Streams à l'aide de cette solution.
La fin du pipeline de flux multimédia se produit lorsque la réunion est supprimée ou lorsque l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API est invoquée pour ce pipeline de flux multimédia. Une [notification Event Bridge](media-pipe-events.md) est également envoyée pour indiquer la fin du pipeline multimédia.