

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime
<a name="create-concat-pipe"></a>

Si utilizzano pipeline di concatenazione multimediale per concatenare gli artefatti (file) generati dalle pipeline di acquisizione multimediale.

Le pipeline di acquisizione multimediale acquisiscono i contenuti di una riunione suddividendo i flussi multimediali e archiviando gli artefatti nel tuo bucket Amazon S3. Le pipeline di acquisizione multimediale creano i seguenti tipi di artefatti: 
+ Audio
+ Video
+ Condivisioni di contenuti
+ Messaggi sul canale dati
+ Messaggi di trascrizione
+ Eventi di riunione
+ Video composito, ovvero condivisioni di contenuti e flussi video multipli visualizzati in una griglia come riquadri video.

Le pipeline di concatenazione multimediale consentono di concatenare ogni tipo di elemento in un unico file e quindi di archiviare i file più grandi nel bucket Amazon S3. Puoi creare una pipeline di concatenazione multimediale senza attendere il termine dell'evento di acquisizione multimediale, ma la pipeline di concatenazione inizia a concatenarsi solo quando la pipeline di acquisizione si interrompe.

**Nota**  
Le pipeline di acquisizione multimediale, le pipeline di concatenazione multimediale e i bucket Amazon S3 devono risiedere nello stesso account. AWS 

**Topics**
+ [Architettura della pipeline di concatenazione di Amazon Chime SDK](concat-architecture.md)
+ [Creazione di una pipeline di concatenazione multimediale Amazon Chime SDK](create-concat-pipe-steps.md)
+ [Comprensione della struttura delle cartelle bucket di Amazon S3 per le pipeline di concatenazione di Amazon Chime SDK](concat-folder-structure.md)

# Architettura della pipeline di concatenazione di Amazon Chime SDK
<a name="concat-architecture"></a>

Il diagramma seguente mostra l'architettura di una pipeline di concatenazione multimediale.

![\[Diagramma che mostra l'architettura di una pipeline di concatenazione multimediale.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/concatenation-pipe-architecture-2.png)


Nel diagramma, alla ricezione di una [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)richiesta, il piano di controllo della pipeline multimediale avvia una pipeline di acquisizione multimediale nel piano dati della pipeline multimediale. Il piano dati invia quindi i blocchi acquisiti nel bucket di acquisizione ogni 5 secondi. Alla ricezione di una [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)richiesta, il piano di controllo della pipeline multimediale attende il completamento della pipeline di acquisizione multimediale specificata, quindi avvia una pipeline di concatenazione multimediale nel piano dati della pipeline multimediale. Il piano dati legge quindi i blocchi catturati nel bucket e inserisce gli artefatti concatenati nel bucket di concatenazione.

# Creazione di una pipeline di concatenazione multimediale Amazon Chime SDK
<a name="create-concat-pipe-steps"></a>

Segui un processo in più fasi per creare una pipeline di concatenazione multimediale Amazon Chime SDK. I passaggi seguenti descrivono il processo.

1. Crea un bucket Amazon S3 da utilizzare come data sink della pipeline di acquisizione multimediale, quindi configura la policy del bucket. Per informazioni sull'attivazione della crittografia lato server per il bucket Amazon S3, consulta la sezione [Abilitazione della crittografia lato server per un bucket Amazon Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) in questa guida. Se hai creato un bucket Amazon Amazon S3 da utilizzare con pipeline di acquisizione multimediale, devi aggiungere `s3:ListBucket` le azioni `s3:GetObject` e alla policy di quel bucket. L'`s3:ListBucket`azione richiede l'autorizzazione sul bucket. Le altre azioni richiedono l'autorizzazione per gli oggetti nel bucket. È necessario utilizzare due diversi Amazon Resource Names (ARNs) per specificare le autorizzazioni a livello di bucket e a livello di oggetto.

   L'esempio seguente mostra la policy del bucket. Copia e incolla questo esempio in base alle esigenze.

------
#### [ 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.  Crea un bucket Amazon Amazon S3 da utilizzare come data sink della pipeline di concatenazione multimediale, quindi configura la policy del bucket. Per informazioni sull'attivazione della crittografia lato server per il bucket Amazon S3, consulta la sezione [Abilitazione della crittografia lato server per un bucket Amazon Amazon S3](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html) in questa guida. 

   L'esempio seguente mostra la policy.

------
#### [ 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**  
Puoi utilizzare un singolo bucket Amazon S3 per le pipeline di acquisizione e concatenazione dei contenuti multimediali. Tuttavia, se lo fai, devi aggiungere le `s3:ListBucket` autorizzazioni `s3:GetObject` e alla policy del bucket di concatenazione multimediale illustrata nel passaggio 2. Se non desideri che la politica dei bucket di concatenazione disponga di tali autorizzazioni, crea bucket separati per ogni pipeline. 

1. Usa l'[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)API per creare una pipeline di acquisizione multimediale. Come parte di ciò, ottieni l'ARN del gasdotto. Per informazioni su come ottenere l'ARN, fare riferimento a. [Informazioni sulla creazione di pipeline multimediali con Amazon Chime SDK](create-pipeline.md) Utilizzerai l'ARN nel passaggio successivo.

1. Usa l'[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)API per creare una pipeline di concatenazione.

   L'esempio seguente mostra un corpo della richiesta. Il *Path* campo è facoltativo e il valore predefinito è l'ID della pipeline di concatenazione.
**Nota**  
È necessario utilizzare un file `MediaPipelineArn` creato negli ultimi 30 giorni.

   ```
   {
       "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]"
               }
           }
       ]
   }
   ```

   La concatenazione inizia ogni volta che la pipeline di acquisizione si interrompe. La pipeline di concatenazione si interrompe dopo aver completato la concatenazione.

# Comprensione della struttura delle cartelle bucket di Amazon S3 per le pipeline di concatenazione di Amazon Chime SDK
<a name="concat-folder-structure"></a>

I bucket Amazon S3 per le pipeline di concatenazione multimediale utilizzano questa struttura di cartelle:

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

**Nota**  
**Se specifichi un prefisso quando crei una pipeline multimediale, il percorso delle cartelle diventa nome/prefisso del bucket.** *Senza un prefisso, il percorso diventa nome del *bucket/ID* della pipeline multimediale.* Si specifica un prefisso nel `Destination` campo dell'oggetto. `S3BucketSinkConfiguration` *I nomi di file concatenati sono costituiti dall'ID della *pipeline multimediale .mp4 per i file multimediali e dall'ID* della pipeline multimediale .txt per i file di testo.*