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 capture multimédia pour les réunions du SDK Amazon Chime Les pipelines de capture multimédia capturent les flux audio, vidéo et de partage de contenu, ainsi que les événements de réunion et les messages de données. Tous les pipelines de capture multimédia enregistrent leurs données dans un compartiment [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) que vous créez. Vous pouvez créer un pipeline de capture multimédia par réunion du SDK Amazon Chime. Les sections suivantes expliquent comment créer un pipeline de capture multimédia. Suivez-les dans l’ordre affiché. **Topics** + [Création d'un compartiment Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime](create-s3-bucket.md) + [Activation du chiffrement côté serveur pour un compartiment Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime](sse-kms.md) + [Activation du chiffrement côté serveur au niveau de l'objet avec clé AWS KMS](using-kms-keys-for-encryption.md) + [Création du pipeline de capture multimédia du SDK Amazon Chime](create-capture-pipe.md) + [Utilisation des artefacts de capture multimédia du SDK Amazon Chime](artifacts.md) + [Configuration du dossier audio pour les pipelines de capture multimédia du SDK Amazon Chime](configure-audio.md) + [Configuration du dossier vidéo pour les pipelines de capture multimédia du SDK Amazon Chime](configure-video.md) + [Comprendre les messages contenus dans le dossier des canaux de données pour les pipelines de capture multimédia du SDK Amazon Chime](data-channel.md) + [Comprendre la structure des dossiers de compartiments Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime](capture-folder-structure.md) + [Comprendre les fichiers d'événements de réunion pour les pipelines de capture multimédia du SDK Amazon Chime](meeting-events.md) + [Comprendre les fichiers de transcription pour les pipelines de capture multimédia du SDK Amazon Chime](transcription-messages.md) + [Concaténation de flux de données pour les pipelines de capture multimédia du SDK Amazon Chime](concatenate-streams.md) # Création d'un compartiment Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime Vous pouvez utiliser la console Amazon S3 ou la AWS CLI pour créer un compartiment Amazon S3. AWS SDKs Pour plus d'informations, reportez-vous à la section [Création d'un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service (S3)*. Le compartiment Amazon S3 pour votre pipeline de capture multimédia doit appartenir au même AWS compte que la réunion du SDK Amazon Chime. [En outre, vous devez accorder l'`s3:PutObjectAcl`autorisation `s3:PutObject` et au service Amazon Chime SDK principal mediapipelines.chime.amazonaws.com.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) Vous pouvez le faire avec la console Amazon S3 ou le AWS Command Line Interface (AWS CLI). Le compartiment Amazon S3 doit appartenir à l'une des régions multimédias du [SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) disponibles. **Note** Assurez-vous d'ajouter une politique à votre utilisateur IAM pour autoriser l'accès à votre bucket. De plus, si vous utilisez une région qui est AWS désactivée par défaut, vous devez disposer d'un compartiment Amazon S3 dans cette région. Par défaut, AWS désactive les régions suivantes, et vous ne pouvez pas y héberger de ressources de réunion tant que vous ne les avez pas activées : Afrique (Le Cap) Asie-Pacifique (Hong Kong) Asie-Pacifique (Jakarta) Europe (Milan) Middle East (Bahrain) Si vous utilisez l'une de ces régions, elle doit disposer d'un compartiment Amazon S3. Cela s'applique même si vous utilisez Amazon S3 APIs pour communiquer avec des régions qui ne sont pas bloquées par défaut et qui possèdent déjà un compartiment. Pour plus d'informations sur l'activation des régions bloquées, reportez-vous à [la section Gestion des régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le *manuel de référence général AWS*. Une fois que vous avez créé un bucket, enregistrez son ARN. Vous l'utilisez pour créer un pipeline de capture multimédia. L'exemple suivant montre une politique de compartiment Amazon S3. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "AWSChimeMediaCaptureBucketPolicy", "Statement": [ { "Sid": "AWSChimeMediaCaptureBucketPolicy", "Effect": "Allow", "Principal": { "Service": "mediapipelines.chime.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::Bucket_Name/*", "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*:123456789012:*" } } } ] } ``` ------ # Activation du chiffrement côté serveur pour un compartiment Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime Pour activer le chiffrement côté serveur pour un bucket Amazon Simple Storage Service (Amazon S3), vous pouvez utiliser les types de clés de chiffrement suivants : + Une clé gérée par Amazon S3 + Une clé gérée par le client dans le service de gestion des AWS clés (KMS) **Note** Le service de gestion des clés prend en charge deux types de clés : les clés gérées par le client et les clés AWS gérées. Les réunions du SDK Amazon Chime ne prennent en charge que les clés gérées par le client. ## Utilisation d'une clé gérée par Amazon S3 Vous utilisez la console Amazon S3, la CLI ou l'API REST pour activer le chiffrement côté serveur pour un compartiment Amazon S3. Dans les deux cas, choisissez **Amazon S3 Key** comme type de clé de chiffrement. Aucune autre action n'est nécessaire. Lorsque vous utilisez le bucket pour la capture multimédia, les artefacts sont téléchargés et chiffrés côté serveur. Pour plus d'informations, reportez-vous à la section [Spécification du chiffrement Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) dans le *guide de l'utilisateur Amazon S3*. ## À l'aide d'une clé que vous possédez Pour activer le chiffrement avec une clé que vous gérez, vous devez activer le chiffrement côté serveur du compartiment Amazon S3 à l'aide d'une clé gérée par le client, puis ajouter une déclaration à la politique en matière de clés qui autorise Amazon Chime à utiliser la clé et à chiffrer tous les artefacts chargés. 1. Créez une clé gérée par le client dans KMS. Pour plus d'informations à ce sujet, consultez la section [Spécification du chiffrement côté serveur avec AWS KMS (SSE-KMS)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html) dans le guide de l'utilisateur *Amazon* S3. 1. Ajoutez une déclaration à la politique des clés qui permet à l'`GenerateDataKey`action de générer une clé à utiliser par le principal du service Amazon Chime SDK,. `mediapipelines.chime.amazonaws.com` Cet exemple montre une déclaration typique. ``` ... { "Sid": "MediaPipelineSSEKMS", "Effect": "Allow", "Principal": { "Service": "mediapipelines.chime.amazonaws.com" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "Account_Id" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*:Account_Id:*" } } } ... ``` 1. Si vous utilisez un pipeline de concaténation multimédia, ajoutez une déclaration à la politique clé qui autorise le principal du service Amazon Chime SDK à utiliser l'action. `mediapipelines.chime.amazonaws.com` `kms:Decrypt` 1. Configurez le compartiment Amazon S3 pour activer le chiffrement côté serveur avec la clé. # Activation du chiffrement côté serveur au niveau de l'objet avec clé AWS KMS Le pipeline de capture multimédia et le pipeline de concaténation multimédia peuvent utiliser AWS Key Management Service (AWS KMS) des clés gérées par le client pour activer le chiffrement côté serveur (SSE) pour les objets individuels d'un compartiment Amazon S3. Pour configurer cela, vous devez utiliser l'appel [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)d'API. Le pipeline de concaténation multimédia utilisera les paramètres de chiffrement côté serveur du pipeline de capture multimédia associé. Pour activer le SSE pour des objets individuels (SSE au niveau de l'objet) à l'aide de votre clé gérée par le AWS KMS client, vous devez fournir la `SseAwsKeyManagementParams` structure et le `SinkIamRoleArn` lors de l'appel d'[CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)API : 1. Utilisez le `AwsKmsKeyId` paramètre de la `SseAwsKeyManagementParams` structure pour spécifier la AWS KMS clé. Vous pouvez spécifier l'ID de clé à l'aide de l'ID, de l'ARN ou de l'alias de la clé. 1. Utilisez le `SinkIamRoleArn` paramètre pour spécifier le rôle IAM pour accéder à la AWS KMS clé et au compartiment Amazon S3 du récepteur. 1. Vous pouvez éventuellement utiliser le `AwsKmsEncryptionContext` paramètre dans la `SseAwsKeyManagementParams` structure pour spécifier le contexte de chiffrement à utiliser ainsi que les artefacts AWS KMS clés pour renforcer la sécurité. **Note** Les `SinkIamRoleArn` paramètres `AwsKmsKeyId` et sont co-dépendants. Lorsque les deux sont présents et valides, le Media Capture Pipeline assume le rôle et place chaque artefact dans le bucket sink Amazon S3 spécifié avec la clé spécifiée. AWS KMS L'appel [CreateMediaConcatenationPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)d'API n'a pas de nouveaux paramètres mais utilisera les paramètres susmentionnés s'ils sont spécifiés. Si vous prévoyez de concaténer des artefacts, assurez-vous que la configuration de vos ressources est définie comme décrit dans la [Configuration](#using-kms-keys-for-encryption-config) section suivante et qu'elle est persistante dans le temps. ## Configuration Ils `SinkIamRoleArn` doivent disposer des mêmes autorisations et du même accès que le principal pour placer des artefacts dans le compartiment Amazon S3. Pour plus d'informations sur les autorisations par défaut attendues dans le compartiment Amazon S3, consultez [Création d'un compartiment Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-s3-bucket.html). Pour activer SSE pour des objets individuels, votre compartiment Amazon S3 doit autoriser le rôle IAM spécifié à l'aide du `SinkIamRoleArn` à effectuer le même ensemble d'actions que celui que vous attendez de l'identité IAM appelante. Vous pouvez y parvenir en ajoutant le principe suivant à votre politique d'autorisation de compartiment Amazon S3. ``` ... "Principal": { ... "AWS": "arn:aws:iam::;:role/" ... }, ... ``` Le `AwsKmsKeyId` doit pointer vers une touche qui permet de `SinkIamRoleArn` l'exécuter`GenerateDataKey`. Si Media Concatenation Pipeline doit être utilisé, la AWS KMS clé doit également autoriser l'utilisation de l'action. `Decrypt` Consultez l'exemple suivant. **Note** La ressource est configurée pour utiliser un caractère générique`“*”`, ce qui, dans le contexte d'une politique AWS KMS clé, signifie « elle-même ». ``` { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam:::role/" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ``` Le `SinkIamRoleArn` rôle doit avoir une relation de confiance permettant au service de l'assumer. Consultez l'exemple suivant. ``` { "Effect": "Allow", "Principal": { "Service": "mediapipelines.chime.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*::*" } } } ``` La politique d'autorisation minimale suivante `SinkIamRoleArn` doit être appliquée pour Media Capture Pipeline. Consultez l'exemple suivant. ``` { "Effect": "Allow", "Action": "kms:GenerateDataKey", "Resource": "arn:aws:kms:::key/", "Condition": { "StringEquals": { "aws:SourceAccount": "" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*::*" } } }, { "Effect": "Allow", "Action": ["s3:PutObject", "s3:PutObjectAcl"], "Resource": "arn:aws:s3:::/*", "Condition": { "StringEquals": { "aws:SourceAccount": "" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*::*" } } } ``` De plus, l'appelant doit être autorisé à accéder `SinkIamRoleArn` au service. Dans les cas où l'appelant n'a pas cette autorisation, celle-ci doit être ajoutée explicitement. Consultez l'exemple suivant. ``` { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "", "Condition": { "ArnLike": { "iam:AssociatedResourceArn": "arn:aws:chime:*::media-pipeline/*" }, "StringEquals": { "iam:PassedToService": "mediapipelines.chime.amazonaws.com" } } } ``` ## Implémentation de la concaténation des médias Si vous prévoyez d'utiliser Media Concatenation Pipeline après Media Capture, consultez la section [Création d'un pipeline de concaténation multimédia du SDK Amazon Chime](create-concat-pipe-steps.md) pour comprendre les autorisations requises. Pour que le pipeline fonctionne avec la AWS KMS clé pour le SSE au niveau de l'objet, les `SinkIamRoleArn` autorisations (actions autorisées) doivent être étendues pour la AWS KMS clé et le compartiment Amazon S3. Consultez l'exemple suivant. ``` ... { ... { ... "Action": ["kms:GenerateDataKey","kms:Decrypt"] "Resource": "arn:aws:kms:::key/", ... } ... { "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket"], "Resource": "arn:aws:s3:::/*", } ... } ... ``` # Création du pipeline de capture multimédia du SDK Amazon Chime Après avoir créé et configuré votre ou vos compartiments Amazon S3, vous créez un pipeline de capture multimédia. **Pour créer un pipeline de capture multimédia** + Appelez l'API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html). Utilisez l'ARN du bucket comme `SinkArn` paramètre. En cas de réussite, le SDK Amazon Chime crée un participant qui rejoint et capture la réunion. Après avoir créé un pipeline de capture multimédia et défini ses autorisations, vous créez un pipeline de concaténation multimédia pour concaténer les fragments multimédia de 5 secondes en un seul fichier. Pour plus d'informations, reportez-vous à[Création de pipelines de concaténation multimédia pour les réunions du SDK Amazon Chime](create-concat-pipe.md), plus loin dans cette section. # Utilisation des artefacts de capture multimédia du SDK Amazon Chime Lors d'une réunion du SDK Amazon Chime, un pipeline de capture multimédia crée les types d'artefacts suivants. + Audio + Vidéo + Messages relatifs aux canaux de données + Événements liés à des réunions + Messages de transcription Le pipeline crée les artefacts dans un ensemble de dossiers de votre compartiment Amazon S3, et vous pouvez configurer les dossiers audio et vidéo pour limiter certains types d'artefacts. Les sections suivantes expliquent la structure des dossiers, comment configurer les dossiers, comment définir les autorisations pour votre compartiment Amazon S3 et comment concaténer les fichiers d'artefacts. # Configuration du dossier audio pour les pipelines de capture multimédia du SDK Amazon Chime Le dossier audio contient des MP4 fichiers de 5 secondes du flux audio mixé, ce qui signifie qu'ils contiennent le son de tous les participants, ainsi que la vidéo de l'orateur actif. Le dossier contient des fichiers pour l'ensemble de la réunion. Si vous le souhaitez, vous pouvez configurer le dossier pour qu'il ne contienne que les artefacts audio. Chaque nom de fichier contient un min-seconds-milleseconds horodatage *yyyy-mm-dd-hour-*. L'horodatage est en UTC et marque l'heure de début. Vous pouvez configurer le dossier pour qu'il contienne uniquement des artefacts audio. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "State": "Disabled" } } ``` # Configuration du dossier vidéo pour les pipelines de capture multimédia du SDK Amazon Chime Le dossier vidéo contient des MP4 fichiers de 5 secondes contenant des flux vidéo, ainsi que des flux de partage de contenu s'ils sont spécifiés dans la demande d'API. Chaque nom de fichier contient un horodatage < yyyy-mm-dd-hour - min-seconds-milleseconds >- avec un identifiant de participant. Le fragment vidéo de partage de contenu est ajouté sous la forme < yyyy-mm-dd-hour - min-seconds-milleseconds >- \$1content .mp4. Vous pouvez configurer le dossier pour qu'il ne contienne que des artefacts vidéo. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "MuxType": "VideoOnly" "State": "Enabled" } } ``` # Comprendre les messages contenus dans le dossier des canaux de données pour les pipelines de capture multimédia du SDK Amazon Chime Le dossier data-channel contient des messages de données au format .txt, et chaque message est un objet JSON. Les messages sont visibles avec toutes les options de configuration. Les noms de fichiers contiennent l'min-seconds-millesecondshorodatage *yyyy-mm-dd-hour-*. Cet exemple montre les champs de données d'un message. ``` { "Timestamp": "string", "Topic": "string", "Data": "string", "SenderAttendeeId": "string" } ``` # Comprendre la structure des dossiers de compartiments Amazon S3 pour les pipelines de capture multimédia du SDK Amazon Chime Les compartiments Amazon S3 pour les pipelines de capture multimédia utilisent cette structure de dossiers. ``` S3 bucket path/ audio video data-channel meeting-events transcription-messages ``` # Comprendre les fichiers d'événements de réunion pour les pipelines de capture multimédia du SDK Amazon Chime Le dossier meeting-events contient les événements de réunion au format .txt, et chaque événement est un objet JSON. Les messages sont visibles avec toutes les options de configuration. Les noms de fichiers contiennent l'horodatage < yyyy-mm-dd-hour min-seconds-milleseconds ->. Cet exemple montre les champs et les données d'un fichier d'événement classique. ``` { "Timestamp": "string", "EventType": "AttendeeJoined | AttendeeLeft | AttendeeVideoJoined | AttendeeVideoLeft | ActiveSpeaker | CaptureStarted | CaptureEnded | AudioTrackMute | AudioTrackUnmute", "EventParameters": { # ... } } ``` # Comprendre les fichiers de transcription pour les pipelines de capture multimédia du SDK Amazon Chime Le dossier transcription-messages contient les fichiers de transcription au format .txt. Toutefois, le dossier ne reçoit des fichiers que lorsque vous activez la transcription en direct. Pour plus d'informations sur l'activation de la transcription en direct, consultez[Utilisation de la transcription en direct du SDK Amazon Chime](meeting-transcription.md). Le dossier inclut tous les messages de transcription partiels et complets, et chaque message est un objet JSON. Les noms de fichiers contiennent l'horodatage < yyyy-mm-dd-hour min-seconds-milleseconds ->. Vous pouvez consulter des exemples de fichiers de transcription sur[Traitement d'un événement de transcription en direct du SDK Amazon Chime reçu](delivery-examples.md). # Concaténation de flux de données pour les pipelines de capture multimédia du SDK Amazon Chime **Note** Pour automatiser le processus de concaténation des artefacts de capture multimédia, reportez-vous [Création de pipelines de concaténation multimédia pour les réunions du SDK Amazon Chime](create-concat-pipe.md) à ce guide. Cet exemple utilise ffmpeg pour concaténer des fichiers vidéo ou audio en un seul fichier mp4. Créez d'abord un fichier filelist.txt contenant tous les fichiers d'entrée. Utilisez ce format : ``` file 'input1.mp4' file 'input2.mp4' file 'input3.mp4' ``` Ensuite, utilisez cette commande pour concaténer le fichier d'entrée : ``` ffmpeg -f concat -i filelist.txt -c copy output.mp4 ``` Pour plus d'informations sur les pipelines de concaténation de médias, reportez-vous [Création de pipelines de concaténation multimédia pour les réunions du SDK Amazon Chime](create-concat-pipe.md) à ce guide.