Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Creación de canalizaciones de captura multimedia en las reuniones de Amazon Chime SDK Las canalizaciones de captura multimedia capturan transmisiones de audio, video y contenido compartido, además de eventos de reuniones y mensajes de datos. Todas las canalizaciones de captura multimedia guardan sus datos en el bucket de [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) que usted cree. Puede crear una canalización de captura de contenido multimedia por reunión de Amazon Chime SDK. En las siguientes secciones se explica cómo crear una canalización de captura multimedia. Siga las instrucciones en el orden en el que se enumeran. **Topics** + [Creación de un bucket de Amazon S3 para canalizaciones de captura multimedia de Amazon Chime SDK](create-s3-bucket.md) + [Activación del cifrado en el servidor para un bucket de Amazon S3 para las canalizaciones de captura multimedia de Amazon Chime SDK](sse-kms.md) + [Habilitar el cifrado del lado del servidor a nivel de objeto con clave AWS KMS](using-kms-keys-for-encryption.md) + [Creación de la canalización de captura multimedia de Amazon Chime SDK](create-capture-pipe.md) + [Uso de artefactos de captura multimedia de Amazon Chime SDK](artifacts.md) + [Configuración de la carpeta de audio para las canalizaciones de captura multimedia de Amazon Chime SDK](configure-audio.md) + [Configuración de la carpeta de video para las canalizaciones de captura multimedia de Amazon Chime SDK](configure-video.md) + [Descripción de los mensajes de la carpeta del canal de datos para las canalizaciones de captura multimedia de Amazon Chime SDK](data-channel.md) + [Descripción de la estructura de carpetas de bucket de Amazon S3 para las canalizaciones de captura multimedia de Amazon Chime SDK](capture-folder-structure.md) + [Descripción de los archivos de eventos de reuniones para las canalizaciones de captura multimedia de Amazon Chime SDK](meeting-events.md) + [Descripción de los archivos de transcripción para las canalizaciones de captura multimedia de Amazon Chime SDK](transcription-messages.md) + [Concatenación de flujos de datos para las canalizaciones de captura multimedia de Amazon Chime SDK](concatenate-streams.md) # Creación de un bucket de Amazon S3 para canalizaciones de captura multimedia de Amazon Chime SDK Puede usar la consola Amazon S3 AWS SDKs, la o la AWS CLI para crear un bucket de Amazon S3. Para obtener más información, consulte [Creación de un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) en la *Guía del usuario de Amazon Simple Storage Service (S3)*. El bucket de Amazon S3 de su canalización de captura multimedia debe pertenecer a la misma cuenta de AWS que la reunión de Amazon Chime SDK. Además, debe conceder permiso para `s3:PutObject` y `s3:PutObjectAcl` a la entidad principal de servicio de Amazon Chime SDK, [mediapipelines.chime.amazonaws.com.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) Puede hacerlo con la consola Amazon S3 o con AWS Command Line Interface (AWS CLI). El bucket de Amazon S3 debe pertenecer a una de las [regiones multimedia de Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html) disponibles. **nota** Asegúrese de añadir una política a su usuario de IAM para conceder acceso a su bucket. Además, si utiliza una región que está AWS deshabilitada de forma predeterminada, debe tener un bucket de Amazon S3 en esa región. De forma predeterminada, AWS deshabilita las siguientes regiones y no puede alojar recursos para reuniones en ellas hasta que las habilite: África (Ciudad del Cabo) Asia-Pacífico (Hong Kong) Asia-Pacífico (Yakarta) Europa (Milán) Middle East (Bahrain) Si utiliza una de esas regiones, debe tener un bucket de Amazon S3. Esto se aplica incluso si utiliza Amazon S3 APIs para comunicarse con regiones que no están bloqueadas de forma predeterminada y que ya tienen un bucket. Para obtener más información sobre cómo habilitar regiones bloqueadas, consulte [Administración de regiones de AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) en la *Referencia general de AWS*. Una vez que haya creado un bucket, registre su ARN. Se utiliza para crear una canalización de captura multimedia. El siguiente ejemplo muestra una política de un bucket de 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:*" } } } ] } ``` ------ # Activación del cifrado en el servidor para un bucket de Amazon S3 para las canalizaciones de captura multimedia de Amazon Chime SDK Para habilitar el cifrado en el servidor para un bucket de Amazon Simple Storage Service (Amazon S3), puede utilizar estos tipos de claves de cifrado: + Una clave administrada de Amazon S3 + Una clave administrada por el cliente en el Servicio de administración de AWS claves (KMS) **nota** El servicio de administración de claves admite dos tipos de claves, las claves administradas por el cliente y las claves AWS administradas. Las reuniones de Amazon Chime SDK solo admiten claves administradas por el cliente. ## Uso de una clave administrada de Amazon S3 Utilice la consola de Amazon S3, la CLI o la API de REST para habilitar el cifrado en el servidor para un bucket de Amazon S3. En ambos casos, elija **Amazon S3 Key** como tipo de clave de cifrado. No hay que hacer nada más. Cuando se utiliza el depósito para la captura de contenido multimedia, los artefactos se cargan y cifran en el servidor. Para obtener más información, consulte [Especificación del cifrado de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) en la *Guía del usuario de Amazon S3*. ## Uso de una clave de su propiedad Para habilitar el cifrado con una clave que usted administre, debe habilitar el cifrado del lado del servidor del bucket de Amazon S3 con una clave administrada por el cliente y, a continuación, añadir una declaración a la política de claves que permita a Amazon Chime usar la clave y cifrar cualquier artefacto cargado. 1. Crear una clave administrada por el cliente en KMS. Para obtener información sobre cómo hacerlo, consulte [Especificar el cifrado del lado del servidor con AWS KMS (SSE-KMS)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html) en la Guía del usuario de *Amazon* S3. 1. Añada una instrucción a la política de claves que permita que la acción de `GenerateDataKey` genere una clave para que la utilice la entidad principal del servicio de Amazon Chime SDK, `mediapipelines.chime.amazonaws.com`. En este ejemplo se muestra una instrucción típica. ``` ... { "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 utiliza una canalización de concatenación de contenido multimedia, añada una instrucción a la política de claves que permita a la entidad principal del servicio de Amazon Chime SDK, `mediapipelines.chime.amazonaws.com`, utilizar la acción de `kms:Decrypt`. 1. Configure el bucket de Amazon S3 para habilitar el cifrado del lado del servidor con la clave. # Habilitar el cifrado del lado del servidor a nivel de objeto con clave AWS KMS Media Capture Pipeline y Media Concatenation Pipeline pueden usar AWS Key Management Service (AWS KMS) claves administradas por el cliente para habilitar el cifrado del lado del servidor (SSE) para objetos individuales en un bucket de Amazon S3. Para configurarlo, debe usar la llamada a la API. [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) La canalización de concatenación multimedia utilizará los parámetros de cifrado del lado del servidor de la canalización de captura multimedia asociada. Para habilitar el SSE para objetos individuales (SSE a nivel de objeto) mediante la clave gestionada por el AWS KMS cliente, debe proporcionar la `SseAwsKeyManagementParams` estructura y la siguiente durante la llamada a la API: `SinkIamRoleArn` [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) 1. Utilice el `AwsKmsKeyId` parámetro de la `SseAwsKeyManagementParams` estructura para especificar la AWS KMS clave. Puede especificar el ID de clave mediante el ID, el ARN o el alias de la clave. 1. Utilice el `SinkIamRoleArn` parámetro para especificar la función de IAM para acceder a la AWS KMS clave y al bucket receptor de Amazon S3. 1. Si lo desea, puede utilizar el `AwsKmsEncryptionContext` parámetro de la `SseAwsKeyManagementParams` estructura para especificar el contexto de cifrado que se va a utilizar junto con los artefactos AWS KMS clave para mejorar la seguridad. **nota** Los `SinkIamRoleArn` parámetros `AwsKmsKeyId` y son codependientes. Cuando ambos estén presentes y sean válidos, Media Capture Pipeline asumirá la función y colocará cada artefacto en el receptáculo de cubos de Amazon S3 especificado con la clave especificada. AWS KMS La llamada a la [CreateMediaConcatenationPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)API no tiene parámetros nuevos, pero utilizará los parámetros antes mencionados si se especifican. Si planea concatenar artefactos, asegúrese de que la configuración de sus recursos esté establecida como se describe en la siguiente [Configuración](#using-kms-keys-for-encryption-config) sección y de que sea persistente a lo largo del tiempo. ## Configuración `SinkIamRoleArn`Debe tener los mismos permisos y acceso que el principal para colocar los artefactos en el bucket de Amazon S3. Para obtener más información sobre los permisos predeterminados esperados en el bucket de Amazon S3, consulte [Creación de un bucket de Amazon S3 para Amazon Chime SDK Media Capture](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-s3-bucket.html) Pipelines. Para habilitar el SSE para objetos individuales, su bucket de Amazon S3 debe permitir que la función de IAM especificada mediante el realice el `SinkIamRoleArn` mismo conjunto de acciones que cabría esperar de la identidad de IAM que realiza la llamada. Para ello, añada el siguiente principio a su política de permisos de buckets de Amazon S3. ``` ... "Principal": { ... "AWS": "arn:aws:iam::;:role/" ... }, ... ``` `AwsKmsKeyId`Debe apuntar a una clave que permita `SinkIamRoleArn` que funcione`GenerateDataKey`. Si se va a utilizar Media Concatenation Pipeline, la AWS KMS clave también debería permitir el uso de la acción. `Decrypt` Consulte el siguiente ejemplo. **nota** El recurso está configurado para usar un comodín`“*”`, que en este contexto de una política AWS KMS clave significa «sí mismo». ``` { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam:::role/" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ``` El `SinkIamRoleArn` rol debe tener una relación de confianza que permita al servicio asumirlo. Consulte el siguiente ejemplo. ``` { "Effect": "Allow", "Principal": { "Service": "mediapipelines.chime.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*::*" } } } ``` `SinkIamRoleArn`Debe tener la siguiente política de permisos mínimos para Media Capture Pipeline. Consulte el siguiente ejemplo. ``` { "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:*::*" } } } ``` Además, la persona que llama debe poder pasar `SinkIamRoleArn` al servicio. En los casos en que la persona que llama no tenga ese permiso, debe añadirse explícitamente. Consulte el siguiente ejemplo. ``` { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "", "Condition": { "ArnLike": { "iam:AssociatedResourceArn": "arn:aws:chime:*::media-pipeline/*" }, "StringEquals": { "iam:PassedToService": "mediapipelines.chime.amazonaws.com" } } } ``` ## Implementación de la concatenación de medios Si planea usar Media Concatenation Pipeline después de Media Capture, asegúrese de conocer [Creación de una canalización de concatenación de contenido multimedia del SDK de Amazon Chime](create-concat-pipe-steps.md) los permisos necesarios. Para que la canalización funcione con la AWS KMS clave del SSE a nivel de objeto, se deben ampliar los `SinkIamRoleArn` permisos (acciones permitidas) de la AWS KMS clave y del bucket de Amazon S3. Consulte el siguiente ejemplo. ``` ... { ... { ... "Action": ["kms:GenerateDataKey","kms:Decrypt"] "Resource": "arn:aws:kms:::key/", ... } ... { "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket"], "Resource": "arn:aws:s3:::/*", } ... } ... ``` # Creación de la canalización de captura multimedia de Amazon Chime SDK Después de crear y configurar su bucket o buckets de Amazon S3, debe crear una canalización de captura multimedia. **Para crear una canalización de captura multimedia** + Llame a la 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). Utilice el ARN de bucket como parámetro `SinkArn`. Cuando se realiza correctamente, Amazon Chime SDK crea un asistente que se une a la reunión y la captura. Después de crear una canalización de captura de contenido multimedia y configurar sus permisos, se crea una canalización de concatenación de contenido multimedia para concatenar los fragmentos multimedia de 5 segundos en un solo archivo. Para obtener más información, consulte [Creación de canalizaciones de concatenaciones multimedia en las reuniones de Amazon Chime SDK](create-concat-pipe.md) más adelante en esta sección. # Uso de artefactos de captura multimedia de Amazon Chime SDK Durante una reunión de Amazon Chime SDK, una canalización de captura de contenido multimedia crea los siguientes tipos de artefactos. + Audio + Video + Mensajes del canal de datos + Eventos de reunión + Mensajes de transcripción La canalización crea los artefactos en un conjunto de carpetas de su bucket de Amazon S3 y usted puede configurar las carpetas de audio y video para limitar determinados tipos de artefactos. En las siguientes secciones se explica la estructura de carpetas, cómo configurar las carpetas, cómo establecer los permisos para su bucket de Amazon S3 y cómo concatenar los archivos de artefactos. # Configuración de la carpeta de audio para las canalizaciones de captura multimedia de Amazon Chime SDK La carpeta de audio contiene MP4 archivos de 5 segundos de la transmisión de audio mixto, lo que significa que contienen el audio de todos los asistentes, además del vídeo del orador activo. La carpeta contiene los archivos de toda la reunión. Si lo desea, puede configurar la carpeta para que contenga solo los artefactos de audio. El nombre de cada archivo contiene una marca de min-seconds-milleseconds tiempo *yyyy-mm-dd-hour:* La marca temporal está en UTC y marca la hora de inicio. Puede configurar la carpeta para que solo contenga artefactos de audio. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "State": "Disabled" } } ``` # Configuración de la carpeta de video para las canalizaciones de captura multimedia de Amazon Chime SDK La carpeta de vídeo contiene MP4 archivos de 5 segundos que contienen secuencias de vídeo, además de secuencias de contenido compartido si se especifican en la solicitud de la API. Cada nombre de archivo contiene una marca de tiempo < yyyy-mm-dd-hour - min-seconds-milleseconds >- con un identificador de asistente. El fragmento de vídeo compartido con el contenido se adjunta como < yyyy-mm-dd-hour - >- min-seconds-milleseconds \$1content .mp4. Puede configurar la carpeta para que solo contenga artefactos de video. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "MuxType": "VideoOnly" "State": "Enabled" } } ``` # Descripción de los mensajes de la carpeta del canal de datos para las canalizaciones de captura multimedia de Amazon Chime SDK La carpeta del canal de datos contiene mensajes de datos en formato .txt y cada mensaje es un objeto JSON. Los mensajes están visibles con todas las opciones de configuración. *Los nombres de los archivos contienen la yyyy-mm-dd-hour marca de tiempo -. min-seconds-milleseconds* En este ejemplo se muestran los campos de datos de un mensaje. ``` { "Timestamp": "string", "Topic": "string", "Data": "string", "SenderAttendeeId": "string" } ``` # Descripción de la estructura de carpetas de bucket de Amazon S3 para las canalizaciones de captura multimedia de Amazon Chime SDK Los buckets de Amazon S3 para las canalizaciones de captura multimedia utilizan esta estructura de carpetas. ``` S3 bucket path/ audio video data-channel meeting-events transcription-messages ``` # Descripción de los archivos de eventos de reuniones para las canalizaciones de captura multimedia de Amazon Chime SDK La carpeta meeting-events contiene los eventos de la reunión en formato .txt y cada evento es un objeto JSON. Los mensajes están visibles con todas las opciones de configuración. Los nombres de los archivos contienen la marca de tiempo < yyyy-mm-dd-hour - min-seconds-milleseconds >. En este ejemplo se muestran los campos y los datos de un archivo de eventos típico. ``` { "Timestamp": "string", "EventType": "AttendeeJoined | AttendeeLeft | AttendeeVideoJoined | AttendeeVideoLeft | ActiveSpeaker | CaptureStarted | CaptureEnded | AudioTrackMute | AudioTrackUnmute", "EventParameters": { # ... } } ``` # Descripción de los archivos de transcripción para las canalizaciones de captura multimedia de Amazon Chime SDK La carpeta de mensajes de transcripción contiene archivos de transcripción en formato .txt. Sin embargo, la carpeta solo recibe archivos cuando se habilita la transcripción en directo. Para obtener más información acerca de cómo activar la transcripción en directo, consulte [Uso de la transcripción en directo de Amazon Chime Amazon Chime SDK](meeting-transcription.md). La carpeta incluye todos los mensajes de transcripción parciales y completos, y cada mensaje es un objeto JSON. Los nombres de los archivos contienen la marca de tiempo < yyyy-mm-dd-hour - min-seconds-milleseconds >. Puede ver ejemplos de archivos de transcripción en [Procesamiento de un evento de transcripción en vivo de Amazon Chime SDK](delivery-examples.md). # Concatenación de flujos de datos para las canalizaciones de captura multimedia de Amazon Chime SDK **nota** Para automatizar el proceso de concatenación de artefactos de captura multimedia, consulte [Creación de canalizaciones de concatenaciones multimedia en las reuniones de Amazon Chime SDK](create-concat-pipe.md) en esta guía. En este ejemplo, se utiliza ffmpeg para concatenar archivos de video o audio en un único archivo mp4. En primer lugar, cree un archivo filelist.txt que contenga todos los archivos de entrada. Utilice este formato: ``` file 'input1.mp4' file 'input2.mp4' file 'input3.mp4' ``` A continuación, utilice este comando para concatenar el archivo de entrada: ``` ffmpeg -f concat -i filelist.txt -c copy output.mp4 ``` Para obtener más información acerca de canalización de concatenación multimedia, consulte [Creación de canalizaciones de concatenaciones multimedia en las reuniones de Amazon Chime SDK](create-concat-pipe.md) en esta guía.