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 acquisizione multimediale per le riunioni dell'SDK Amazon Chime Le pipeline di acquisizione multimediale acquisiscono audio, video e flussi di condivisione di contenuti, oltre a eventi di riunioni e messaggi di dati. Tutte le pipeline di acquisizione multimediale salvano i dati in un bucket [Amazon Simple Storage Service](https://aws.amazon.com/s3/) (S3) creato da te. Puoi creare una pipeline di acquisizione multimediale per riunione Amazon Chime SDK. Le seguenti sezioni spiegano come creare una pipeline di acquisizione multimediale. Seguili nell’ordine in cui sono elencati. **Topics** + [Creazione di un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](create-s3-bucket.md) + [Abilitazione della crittografia lato server per un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](sse-kms.md) + [Abilitazione della crittografia lato server a livello di oggetto con chiave AWS KMS](using-kms-keys-for-encryption.md) + [Creazione della pipeline di acquisizione multimediale Amazon Chime SDK](create-capture-pipe.md) + [Utilizzo degli artefatti di acquisizione multimediale dell'SDK Amazon Chime](artifacts.md) + [Configurazione della cartella audio per le pipeline di acquisizione multimediale di Amazon Chime SDK](configure-audio.md) + [Configurazione della cartella video per le pipeline di acquisizione multimediale di Amazon Chime SDK](configure-video.md) + [Comprensione dei messaggi nella cartella data-channel per le pipeline di acquisizione multimediale di Amazon Chime SDK](data-channel.md) + [Comprensione della struttura delle cartelle bucket di Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](capture-folder-structure.md) + [Informazioni sui file degli eventi delle riunioni per le pipeline di acquisizione multimediale di Amazon Chime SDK](meeting-events.md) + [Informazioni sui file di trascrizione per le pipeline di acquisizione multimediale di Amazon Chime SDK](transcription-messages.md) + [Concatenazione di flussi di dati per le pipeline di acquisizione multimediale di Amazon Chime SDK](concatenate-streams.md) # Creazione di un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK Puoi utilizzare la console Amazon S3 o la AWS SDKs AWS CLI per creare un bucket Amazon S3. Per ulteriori informazioni, consulta [Creating a bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html), nella *Amazon Simple Storage Service (S3) User Guide*. Il bucket Amazon S3 per la tua pipeline di acquisizione multimediale deve appartenere allo stesso AWS account della riunione Amazon Chime SDK. [Inoltre, devi concedere l'`s3:PutObjectAcl`autorizzazione `s3:PutObject` e l'autorizzazione al responsabile del servizio Amazon Chime SDK mediapipelines.chime.amazonaws.com.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) Puoi farlo con la console Amazon S3 o il AWS Command Line Interface ()AWS CLI. Il bucket Amazon S3 deve appartenere a una delle regioni multimediali SDK [Amazon Chime disponibili](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html). **Nota** Assicurati di aggiungere una policy al tuo utente IAM per concedere l'accesso al tuo bucket. Inoltre, se utilizzi una regione che si AWS disabilita per impostazione predefinita, devi avere un bucket Amazon S3 in quella regione. Per impostazione predefinita, AWS disabilita le seguenti regioni e non puoi ospitare risorse per riunioni in esse finché non le abiliti: Africa (Città del Capo) Asia Pacifico (Hong Kong) Asia Pacifico (Giacarta) Europa (Milano) Medio Oriente (Bahrein) Se utilizzi una di queste regioni, deve avere un bucket Amazon S3. Questo vale anche se utilizzi Amazon S3 APIs per comunicare con regioni che non sono bloccate per impostazione predefinita e dispongono già di un bucket. Per ulteriori informazioni sull'abilitazione delle regioni bloccate, consulta [Managing AWS Regions](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) nell'*AWS General Reference*. Una volta creato un bucket, registrane l'ARN. Lo usi per creare una pipeline di acquisizione multimediale. L'esempio seguente mostra una policy sui bucket di 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:*" } } } ] } ``` ------ # Abilitazione della crittografia lato server per un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK Per abilitare la crittografia lato server per un bucket Amazon Simple Storage Service (Amazon S3), puoi utilizzare questi tipi di chiavi di crittografia: + Una chiave gestita Amazon S3 + Una chiave gestita dal cliente nel AWS Key Management Service (KMS) **Nota** Il servizio di gestione delle chiavi supporta due tipi di chiavi, chiavi gestite dal cliente e chiavi AWS gestite. Le riunioni di Amazon Chime SDK supportano solo le chiavi gestite dai clienti. ## Utilizzo di una chiave gestita Amazon S3 Utilizza la console Amazon S3, l'interfaccia a riga di comando o l'API REST per abilitare la crittografia lato server per un bucket Amazon S3. In entrambi i casi, scegli **Amazon S3 Key come tipo di chiave** di crittografia. Non sono necessarie ulteriori azioni. Quando si utilizza il bucket per l'acquisizione di file multimediali, gli artefatti vengono caricati e crittografati sul lato server. Per ulteriori informazioni, consulta la sezione [Specificare la crittografia di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-s3-encryption.html) nella *Amazon S3* User Guide. ## Utilizzando una chiave di tua proprietà Per abilitare la crittografia con una chiave gestita da te, devi abilitare la crittografia lato server del bucket Amazon S3 con una chiave gestita dal cliente, quindi aggiungere una dichiarazione alla politica della chiave che consenta ad Amazon Chime di utilizzare la chiave e crittografare eventuali artefatti caricati. 1. Crea una chiave gestita dal cliente in KMS. *Per informazioni su questa operazione, consulta [Specificare la crittografia lato server con AWS KMS (SSE-KMS) nella Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html).* 1. Aggiungi una dichiarazione alla policy chiave che consenta all'`GenerateDataKey`azione di generare una chiave da utilizzare da parte del responsabile del servizio Amazon Chime SDK,. `mediapipelines.chime.amazonaws.com` Questo esempio mostra una dichiarazione tipica. ``` ... { "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. Se utilizzi una pipeline di concatenazione multimediale, aggiungi una dichiarazione alla policy chiave che consenta al responsabile del servizio Amazon Chime SDK, di utilizzare l'azione. `mediapipelines.chime.amazonaws.com` `kms:Decrypt` 1. Configura il bucket Amazon S3 per abilitare la crittografia lato server con la chiave. # Abilitazione della crittografia lato server a livello di oggetto con chiave AWS KMS Media Capture Pipeline e Media Concatenation Pipeline possono utilizzare AWS Key Management Service (AWS KMS) chiavi gestite dal cliente per abilitare la crittografia lato server (SSE) per singoli oggetti in un bucket Amazon S3. Per configurarlo, è necessario utilizzare la chiamata API. [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) Media Concatenation Pipeline utilizzerà i parametri di crittografia lato server della Media Capture Pipeline associata. Per abilitare SSE per singoli oggetti (SSE a livello di oggetto) utilizzando la chiave gestita dal AWS KMS cliente, è necessario fornire la struttura e durante la chiamata API: `SseAwsKeyManagementParams` `SinkIamRoleArn` [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) 1. Utilizzate il `AwsKmsKeyId` parametro nella `SseAwsKeyManagementParams` struttura per specificare la chiave. AWS KMS È possibile specificare l'ID della chiave utilizzando l'ID, l'ARN o l'alias della chiave. 1. Utilizza il `SinkIamRoleArn` parametro per specificare il ruolo IAM per accedere alla AWS KMS chiave e al bucket sink Amazon S3. 1. Facoltativamente, puoi utilizzare il `AwsKmsEncryptionContext` parametro nella `SseAwsKeyManagementParams` struttura per specificare il contesto di crittografia da utilizzare insieme agli AWS KMS elementi chiave per una maggiore sicurezza. **Nota** I `SinkIamRoleArn` parametri `AwsKmsKeyId` and sono co-dipendenti. Quando entrambi sono presenti e validi, Media Capture Pipeline assumerà il ruolo e inserirà ogni elemento nel bucket-sink Amazon S3 specificato con la chiave specificata. AWS KMS La chiamata [CreateMediaConcatenationPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html)API non ha nuovi parametri ma utilizzerà i parametri sopra indicati, se specificato. Se prevedi di concatenare gli artefatti, assicurati che la configurazione delle risorse sia impostata come descritto nella [Configurazione](#using-kms-keys-for-encryption-config) sezione seguente e che sia persistente nel tempo. ## Configurazione `SinkIamRoleArn`Deve avere le stesse autorizzazioni e lo stesso accesso del principale per inserire gli artefatti nel bucket Amazon S3. Per ulteriori informazioni sulle autorizzazioni predefinite previste nel bucket Amazon S3, [consulta Creazione di un bucket Amazon S3 per Amazon Chime SDK Media Capture](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-s3-bucket.html) Pipelines. Per abilitare SSE per singoli oggetti, il tuo bucket Amazon S3 deve consentire al ruolo IAM specificato utilizzando `SinkIamRoleArn` il di eseguire lo stesso set di azioni che ti aspetteresti dall'identità IAM chiamante. Puoi raggiungere questo obiettivo aggiungendo il seguente principio alla tua politica di autorizzazione dei bucket Amazon S3. ``` ... "Principal": { ... "AWS": "arn:aws:iam::;:role/" ... }, ... ``` `AwsKmsKeyId`Dovrebbero puntare a una chiave che consenta loro di eseguire. `SinkIamRoleArn` `GenerateDataKey` Se si intende utilizzare Media Concatenation Pipeline, la AWS KMS chiave dovrebbe consentire anche l'uso dell'azione. `Decrypt` Guarda l'esempio seguente. **Nota** La risorsa è impostata per utilizzare caratteri jolly`“*”`, che in questo contesto di politica AWS KMS chiave significa «se stessa». ``` { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam:::role/" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ``` Il `SinkIamRoleArn` ruolo deve avere un rapporto di fiducia che consenta al servizio di assumerlo. Guarda l'esempio seguente. ``` { "Effect": "Allow", "Principal": { "Service": "mediapipelines.chime.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*::*" } } } ``` `SinkIamRoleArn`Dovrebbero avere la seguente politica di autorizzazioni minime per Media Capture Pipeline. Guarda l'esempio seguente. ``` { "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:*::*" } } } ``` Inoltre, al chiamante deve essere consentito di accedere `SinkIamRoleArn` al servizio. Nei casi in cui il chiamante non dispone di tale autorizzazione, questa deve essere aggiunta esplicitamente. Guarda l'esempio seguente. ``` { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "", "Condition": { "ArnLike": { "iam:AssociatedResourceArn": "arn:aws:chime:*::media-pipeline/*" }, "StringEquals": { "iam:PassedToService": "mediapipelines.chime.amazonaws.com" } } } ``` ## Implementazione della concatenazione multimediale Se prevedi di utilizzare Media Concatenation Pipeline dopo Media Capture, consulta per comprendere le autorizzazioni richieste. [Creazione di una pipeline di concatenazione multimediale Amazon Chime SDK](create-concat-pipe-steps.md) Per far funzionare la pipeline con la AWS KMS chiave per l'SSE a livello di oggetto, è necessario espandere `SinkIamRoleArn` le autorizzazioni (azioni consentite) per la chiave e il bucket AWS KMS Amazon S3. Guarda l'esempio seguente. ``` ... { ... { ... "Action": ["kms:GenerateDataKey","kms:Decrypt"] "Resource": "arn:aws:kms:::key/", ... } ... { "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket"], "Resource": "arn:aws:s3:::/*", } ... } ... ``` # Creazione della pipeline di acquisizione multimediale Amazon Chime SDK Dopo aver creato e configurato il tuo bucket o i bucket Amazon S3, crei una pipeline di acquisizione multimediale. **Per creare una pipeline di acquisizione multimediale** + Chiamata dell'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). Usa il bucket ARN come `SinkArn` parametro. Una volta completata l'operazione, l'SDK Amazon Chime crea un partecipante che si unisce alla riunione e la registra. Dopo aver creato una pipeline di acquisizione multimediale e averne impostato le autorizzazioni, crei una pipeline di concatenazione multimediale per concatenare i blocchi multimediali di 5 secondi in un unico file. Per ulteriori informazioni, fare riferimento a, più avanti in questa sezione. [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md) # Utilizzo degli artefatti di acquisizione multimediale dell'SDK Amazon Chime Durante una riunione Amazon Chime SDK, una pipeline di acquisizione multimediale crea i seguenti tipi di artefatti. + Audio + Video + Messaggi relativi al canale dati + Eventi di riunione + Messaggi di trascrizione La pipeline crea gli artefatti in un set di cartelle nel tuo bucket Amazon S3 e puoi configurare le cartelle audio e video per limitare determinati tipi di artefatti. Le seguenti sezioni spiegano la struttura delle cartelle, come configurare le cartelle, come impostare le autorizzazioni per il bucket Amazon S3 e come concatenare i file degli artefatti. # Configurazione della cartella audio per le pipeline di acquisizione multimediale di Amazon Chime SDK La cartella audio contiene MP4 file di 5 secondi del flusso audio misto, il che significa che contiene l'audio di tutti i partecipanti, più il video del relatore attivo. La cartella contiene i file per l'intera riunione. Se lo desideri, puoi configurare la cartella in modo che contenga solo gli artefatti audio. Ogni nome di file contiene un timestamp *yyyy-mm-dd-hour- min-seconds-milleseconds*. Il timestamp è in UTC e indica l'ora di inizio. È possibile configurare la cartella in modo che contenga solo artefatti audio. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "State": "Disabled" } } ``` # Configurazione della cartella video per le pipeline di acquisizione multimediale di Amazon Chime SDK La cartella video contiene MP4 file di 5 secondi che contengono flussi video, oltre a flussi di condivisione di contenuti, se specificati nella richiesta API. Ogni nome di file contiene un timestamp < yyyy-mm-dd-hour - min-seconds-milleseconds >- con un ID partecipante. Il blocco del video di condivisione dei contenuti viene aggiunto come < yyyy-mm-dd-hour - >- min-seconds-milleseconds \$1content .mp4. È possibile configurare la cartella in modo che contenga solo artefatti video. ``` "ArtifactsConfiguration": { "Audio": { "MuxType": "AudioOnly" }, "Content": { "State": "Disabled" }, "Video": { "MuxType": "VideoOnly" "State": "Enabled" } } ``` # Comprensione dei messaggi nella cartella data-channel per le pipeline di acquisizione multimediale di Amazon Chime SDK La cartella data-channel contiene messaggi di dati in formato.txt e ogni messaggio è un oggetto JSON. I messaggi sono visibili con tutte le opzioni di configurazione. I nomi dei file contengono il *yyyy-mm-dd-hourmin-seconds-millesecondstimestamp -*. Questo esempio mostra i campi di dati in un messaggio. ``` { "Timestamp": "string", "Topic": "string", "Data": "string", "SenderAttendeeId": "string" } ``` # Comprensione della struttura delle cartelle bucket di Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK I bucket Amazon S3 per le pipeline di acquisizione multimediale utilizzano questa struttura di cartelle. ``` S3 bucket path/ audio video data-channel meeting-events transcription-messages ``` # Informazioni sui file degli eventi delle riunioni per le pipeline di acquisizione multimediale di Amazon Chime SDK La cartella meeting-events contiene gli eventi delle riunioni nel formato.txt e ogni evento è un oggetto JSON. I messaggi sono visibili con tutte le opzioni di configurazione. I nomi dei file contengono il yyyy-mm-dd-hour timestamp < - min-seconds-milleseconds >. Questo esempio mostra i campi e i dati in un tipico file di eventi. ``` { "Timestamp": "string", "EventType": "AttendeeJoined | AttendeeLeft | AttendeeVideoJoined | AttendeeVideoLeft | ActiveSpeaker | CaptureStarted | CaptureEnded | AudioTrackMute | AudioTrackUnmute", "EventParameters": { # ... } } ``` # Informazioni sui file di trascrizione per le pipeline di acquisizione multimediale di Amazon Chime SDK La cartella dei messaggi di trascrizione contiene file di trascrizione in formato.txt. Tuttavia, la cartella riceve i file solo quando si abilita la trascrizione in tempo reale. Per ulteriori informazioni sull'attivazione della trascrizione dal vivo, consulta. [Utilizzo della trascrizione live di Amazon Chime SDK](meeting-transcription.md) La cartella include tutti i messaggi di trascrizione parziali e completi e ogni messaggio è un oggetto JSON. I nomi dei file contengono il timestamp < yyyy-mm-dd-hour - min-seconds-milleseconds >. Puoi vedere esempi di file di trascrizione su. [Elaborazione di un evento di trascrizione live ricevuto da Amazon Chime SDK](delivery-examples.md) # Concatenazione di flussi di dati per le pipeline di acquisizione multimediale di Amazon Chime SDK **Nota** Per automatizzare il processo di concatenazione degli elementi di acquisizione multimediale, fate riferimento a questa guida. [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md) Questo esempio utilizza ffmpeg per concatenare file video o audio in un singolo file mp4. Innanzitutto, crea un file filelist.txt che contenga tutti i file di input. Utilizzate questo formato: ``` file 'input1.mp4' file 'input2.mp4' file 'input3.mp4' ``` Quindi, usa questo comando per concatenare il file di input: ``` ffmpeg -f concat -i filelist.txt -c copy output.mp4 ``` Per ulteriori informazioni sulle pipeline di concatenazione multimediale, fate riferimento a questa guida. [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md)