

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar pipelines de captura de mídia para reuniões do SDK do Amazon Chime
<a name="create-concat-pipe"></a>

Você usa pipelines de concatenação de mídia para concatenar os artefatos (arquivos) gerados pelos pipelines de captura de mídia.

Os pipelines de captura de mídia capturam o conteúdo de uma reunião fragmentando os fluxos de mídia e armazenando esses artefatos em seu bucket do Amazon S3. Os pipelines de captura de mídia criam os seguintes tipos de artefatos: 
+ Áudio
+ Vídeo
+ Compartilhamentos de conteúdo
+ Mensagens do canal de dados
+ Mensagens de transcrição
+ Eventos de reunião
+ Vídeo composto, ou seja, compartilhamentos de conteúdo e várias transmissões de vídeo exibidas em uma grade como blocos de vídeo.

Os pipelines de concatenação de mídia possibilitam que você concatene cada tipo de artefato em um único arquivo e, depois, armazene esses arquivos maiores no bucket do Amazon S3. Você pode criar um pipeline de concatenação de mídia sem esperar que o evento de captura de mídia termine, mas o pipeline de concatenação só começa a concatenar quando o pipeline de captura é interrompido.

**nota**  
Os pipelines de captura de mídia, os pipelines de concatenação de mídia e os buckets do Amazon S3 devem residir na mesma conta. AWS 

**Topics**
+ [Arquitetura de pipelines de concatenação do SDK do Amazon Chime](concat-architecture.md)
+ [Construindo um pipeline de concatenação de mídia do Amazon Chime SDK](create-concat-pipe-steps.md)
+ [Noções básicas sobre a estrutura de pastas de bucket do Amazon S3 para pipelines de concatenação do SDK do Amazon Chime](concat-folder-structure.md)

# Arquitetura de pipelines de concatenação do SDK do Amazon Chime
<a name="concat-architecture"></a>

O diagrama a seguir mostra a arquitetura de um pipeline de concatenação de mídia.

![\[Diagrama mostrando a arquitetura de um pipeline de concatenação de mídia.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/concatenation-pipe-architecture-2.png)


No diagrama, ao receber uma solicitação [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), o ambiente de gerenciamento de pipelines de mídia inicia um pipeline de captura de mídia no plano de dados do pipeline de mídia. Em seguida, o plano de dados envia os fragmentos capturados para o bucket de captura a cada 5 segundos. Ao receber uma solicitação [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html), o ambiente de gerenciamento de pipelines de mídia aguarda a conclusão do pipeline de captura de mídia especificado e, depois, inicia um pipeline de concatenação de mídia no plano de dados do pipeline de mídia. Em seguida, o plano de dados lê os fragmentos capturados no bucket e envia os artefatos concatenados para o bucket de concatenação.

# Construindo um pipeline de concatenação de mídia do Amazon Chime SDK
<a name="create-concat-pipe-steps"></a>

Você segue um processo de várias etapas para criar um pipeline de concatenação de mídia do SDK do Amazon Chime. As etapas a seguir descrevem o processo.

1. Crie um bucket do Amazon S3 para usar como coletor de dados do pipeline de captura de mídia e configure a política do bucket. Para ter mais informações sobre como habilitar a criptografia do lado do servidor para o bucket do Amazon S3, consulte [Habilitar a criptografia do lado do servidor para um bucket do Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) neste guia. Se você criou um bucket do Amazon S3 para uso com pipelines de captura de mídia, deve adicionar as ações `s3:GetObject` e `s3:ListBucket` à política desse bucket. A ação `s3:ListBucket` requer permissão para o bucket. As outras ações exigem permissão nos objetos no bucket. Você deve usar dois nomes de recursos da Amazon (ARNs) diferentes para especificar permissões no nível do bucket e no nível do objeto.

   O exemplo a seguir mostra a política do bucket. Copie e cole esse exemplo conforme necessário.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Id": "AWSChimeMediaCaptureBucketPolicy",
       "Statement": [
           {
               "Sid": "AWSChimeMediaCaptureBucketPolicy",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "mediapipelines.chime.amazonaws.com"
                   ]
               },
               "Action": [
                   "s3:PutObject",
                   "s3:PutObjectAcl",
                   "s3:GetObject",
                   "s3:ListBucket"
               ],
               "Resource": [
                   "arn:aws:s3:::[Bucket-Name]/*",
                   "arn:aws:s3:::[Bucket-Name]"
               ],
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "123456789012"
                   },
                   "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:123456789012:*"
                   }
               }
           }
       ]
   }
   ```

------

1.  Crie um bucket do Amazon S3 para usar como coletor de dados do pipeline de concatenação de mídia e, depois, configure a política de bucket. Para ter mais informações sobre como habilitar a criptografia do lado do servidor para o bucket do Amazon S3, consulte [Habilitar a criptografia do lado do servidor para um bucket do Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) neste guia. 

   O exemplo a seguir mostra a política.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Id": "AWSChimeMediaConcatenationBucketPolicy",
       "Statement": [
           {
               "Sid": " AWSChimeMediaConcatenationBucketPolicy ",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "mediapipelines.chime.amazonaws.com"
                   ]
               },
               "Action": [
                   "s3:PutObject",
                   "s3:PutObjectAcl",
                   "s3:GetObject",
                   "s3:ListBucket"
               ],
               "Resource": [
                   "arn:aws:s3:::[Bucket-Name]/*",
                   "arn:aws:s3:::[Bucket-Name]"
               ],
               "Condition": {
                   "StringEquals": {
                   "aws:SourceAccount": "123456789012"
                   },
                   "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:123456789012:*"
                   }
               }
           }
       ]
   }
   ```

------
**nota**  
É possível usar um único bucket do Amazon S3 para pipelines de captura e de concatenação de mídia. No entanto, se você fizer isso, deverá adicionar as permissões `s3:GetObject` e `s3:ListBucket` à política do bucket de concatenação de mídia mostrada na etapa 2. Se você não quiser que a política do bucket de concatenação tenha essas permissões, crie buckets separados para cada pipeline. 

1. Use a 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) para criar um pipeline de captura de mídia. Como parte disso, obtenha o ARN do pipeline. Para informações sobre como obter o ARN, consulte [Noções básicas sobre a criação do pipeline de mídia do SDK do Amazon Chime](create-pipeline.md). O ARN será usado na próxima etapa.

1. Use a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html) para criar um pipeline de concatenação.

   O exemplo a seguir mostra um corpo de solicitação. O *Path* campo é opcional e o padrão é o ID do pipeline de concatenação.
**nota**  
Você deve usar um `MediaPipelineArn` criado nos últimos 30 dias.

   ```
   {
       "Sources": [
           {
               "Type": "MediaCapturePipeline",
               "MediaCapturePipelineSourceConfiguration": {
                   "MediaPipelineArn": "Media_Pipeline_Arn",  //must be <30 days old
                   "ChimeSdkMeetingConfiguration": {
                       "ArtifactsConfiguration": {
                           "Audio": {
                               "State": "Enabled"
                           },
                           "Video": {
                               "State": "Enabled | Disabled"
                           },
                           "Content": {
                               "State": "Enabled | Disabled"
                           },
                           "DataChannel": {
                               "State": "Enabled | Disabled"
                           },
                           "TranscriptionMessages": {
                               "State": "Enabled | Disabled"
                           },
                           "MeetingEvents": {
                               "State": "Enabled | Disabled"
                           },
                           "CompositedVideo": {
                               "State": "Enabled | Disabled"
                           }
                       }
                   }
               }
           }
       ],
       "Sinks": [
           {
               "Type": "S3Bucket",
               "S3BucketSinkConfiguration": {
                   "Destination": "arn:aws:s3:::[Bucket_Name]/[Path]"
               }
           }
       ]
   }
   ```

   A concatenação começa sempre que o pipeline de captura é interrompido. O pipeline de concatenação é interrompido após a conclusão da concatenação.

# Noções básicas sobre a estrutura de pastas de bucket do Amazon S3 para pipelines de concatenação do SDK do Amazon Chime
<a name="concat-folder-structure"></a>

Os buckets do Amazon S3 para pipelines de concatenação de mídia usam esta estrutura de pastas:

```
S3 bucket path/
  audio
  video
  composited-video
  data-channel
  meeting-events
  transcription-messages
```

**nota**  
Se você especificar um prefixo ao criar um pipeline de mídia, o caminho para as pastas se tornará *nome do bucket*/*prefixo*. Sem um prefixo, o caminho se torna *nome do bucket*/*ID do pipeline de mídia*. Você especifica um prefixo no campo `Destination` do objeto `S3BucketSinkConfiguration`. Os nomes dos arquivos concatenados consistem em *ID de pipeline de mídia* .mp4 para arquivos de mídia e *ID de pipeline de mídia* .txt para arquivos de texto.