Création de pipelines de flux multimédia dans le 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.

Création de pipelines de flux multimédia dans le SDK Amazon Chime

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'CreateMediaStreamPipelineAPI 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.

Dans le schéma :

  1. Vous appelez l'CreateMediaStreamPipelineAPI. 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 etSourceArn. Vous devez utiliser leChimeSdkMeeting SourceType. SourceArnIl s'agit de l'ARN duChimeSdkMeeting.

    • Le réseau de récepteurs comprend les éléments SinkTypeSinkArn,ReservedStreamCapacity, etMediaStreamType. Nous soutenons uniquement leKinesisVideoStreamPoolSinkType. SinkArnIl s'agit de l'ARN duKinesisVideoStreamPool. Le MediaStreamType contrôle le type de média diffusé vers le récepteur, MixedAudio soitIndividualAudio. ReservedStreamCapacitydéfinit le nombre de flux alloués pour le MediaStreamTypeKinesisVideoStreamPool.

      • Si vous souhaitez diffuser IndividualAudio les deuxMixedAudio, créez deux objets récepteurs dans le Sinks tableau, l'un pourIndividualAudio, l'autre pourMixedAudio. L'SinkArn(l'ARN duKinesisVideoStreamPool) 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.

    • Remarques :

      • Lorsque vous appelez l'CreateMediaStreamPipelineAPI en KinesisVideoStreamPool tant queSinkType, 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 dansus-east-1, vous devez utiliser un KinesisVideoStreamPool inus-east-1.

      • ReservedStreamCapacitydevrait être 1 lorsque vous spécifiez le MixedAudioMediaStreamType, et entre les deux 1-10 lorsque vous spécifiez le IndividualAudioMediaStreamType.

  2. Le plan de données du pipeline multimédia appelle l' PutMediaAPI KVS pour stocker le son individuel dans un flux KVS appartenant au pool KVS que vous spécifiez.

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

Note

Après avoir appelé l'CreateMediaStreamPipelineAPI, les constructeurs peuvent utiliser les événements du pipeline multimédia ou appeler l'GetMediaPipelineAPI pour déterminer si l'état du pipeline est le casInProgress.

Une fois que l'état du pipeline est atteintInProgress, 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. 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 (pourIndividualAudio) 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 ListStreamsKinesis 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'DeleteMediaPipelineAPI est invoquée pour ce pipeline de flux multimédia. Une notification Event Bridge est également envoyée pour indiquer la fin du pipeline multimédia.