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 multimediali SDK Amazon Chime
In questa sezione, ti mostriamo come creare pipeline multimediali, che vengono utilizzate per acquisire o trasmettere in streaming una riunione Amazon Chime SDK. Prima di iniziare, devi integrare l'applicazione client con la libreria client SDK Amazon Chime. Per ulteriori informazioni, consulta [Scopri le librerie client Amazon Chime SDK](mtgs-sdk-client-lib.md). *Per ulteriori informazioni sulle pipeline multimediali, consulta [Capture Amazon Chime SDK Meetings Using media](https://aws.amazon.com/blogs//business-productivity/capture-amazon-chime-sdk-meetings-using-media-capture-pipelines/) pipeline nel AWS blog sulla produttività aziendale.*
**Importante**
Tu e i tuoi utenti finali dovete comprendere che la registrazione delle riunioni dell'SDK Amazon Chime può essere soggetta a leggi o regolamenti riguardanti la registrazione delle comunicazioni elettroniche. È tua responsabilità e dei tuoi utenti finali rispettare tutte le leggi applicabili in materia di registrazioni, inclusa la corretta notifica a tutti i partecipanti a una sessione registrata che la sessione o la comunicazione è in corso di registrazione e ottenere il loro consenso.
Tu e i tuoi utenti finali siete responsabili dello streaming di tutti i contenuti che utilizzano il servizio Media Live Connector e dovete assicurarvi che tali contenuti non violino la legge, violino o si appropriino indebitamente dei diritti di terzi o violino in altro modo i termini materiali del contratto con Amazon.
**Topics**
+ [Considerazioni sulla creazione di pipeline multimediali per Amazon Chime SDK](creating-media-pipelines-considerations.md)
+ [Comprensione dei limiti predefiniti per le pipeline multimediali attive di Amazon Chime SDK](media-pipelines-limits.md)
+ [Migrazione allo spazio dei nomi delle pipeline multimediali di Amazon Chime SDK](migrate-pipelines.md)
+ [Informazioni sulla creazione di pipeline multimediali con Amazon Chime SDK](create-pipeline.md)
+ [Creazione di pipeline di acquisizione multimediale per le riunioni dell'SDK Amazon Chime](capture-pipe-config.md)
+ [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md)
+ [Creazione di pipeline di connettori multimediali live per le riunioni dell'SDK Amazon Chime](connector-pipe-config.md)
+ [Creazione di pipeline di flussi multimediali utilizzando l'SDK Amazon Chime](create-media-stream-pipeline.md)
+ [Composizione di audio e video in un'unica visualizzazione nelle riunioni dell'SDK Amazon Chime](pipeline-compositing.md)
+ [Creazione di un ruolo collegato ai servizi per le pipeline multimediali di Amazon Chime SDK](create-pipeline-role.md)
+ [Utilizzo degli eventi della pipeline multimediale di Amazon Chime SDK](media-pipe-events.md)
+ [Le migliori pratiche per interrompere le pipeline multimediali di Amazon Chime SDK](stop-pipe-best-practices.md)
# Considerazioni sulla creazione di pipeline multimediali per Amazon Chime SDK
Una pipeline multimediale può essere costituita da una di queste pipeline:
+ **Acquisizione** di file multimediali: utilizzate le pipeline di acquisizione multimediale per acquisire flussi di condivisione di audio, video e contenuti, oltre a eventi di riunioni e messaggi di dati. Tutte le pipeline di acquisizione multimediale salvano i dati nel 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. Per ulteriori informazioni, vedi [Informazioni sulla creazione di pipeline multimediali con Amazon Chime SDK](create-pipeline.md).
+ **Concatenazione multimediale: utilizza pipeline di concatenazione** multimediale per concatenare gli elementi da una pipeline di acquisizione multimediale. Le pipeline di concatenazione funzionano indipendentemente dalle pipeline di acquisizione multimediale e live connector. Per ulteriori informazioni, vedi [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md).
+ **Media live connector**: utilizza le pipeline di media live connector per connetterti a servizi che ti consentono di trasmettere in streaming le riunioni di Amazon Chime SDK su un endpoint RTMP. Puoi creare fino a una pipeline di connettori multimediali live per riunione Amazon Chime SDK. Per ulteriori informazioni, vedi [Creazione di pipeline di connettori multimediali live per le riunioni dell'SDK Amazon Chime](connector-pipe-config.md).
+ **Flusso multimediale**: utilizza le pipeline di flussi multimediali per acquisire l'audio individuale per tutti i partecipanti a una riunione, oltre all'audio misto generato da una pipeline di concatenazione multimediale. Tutte le pipeline di flussi multimediali salvano i dati in [Amazon Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) Streams (KVS). Per ulteriori informazioni, vedi [Creazione di pipeline di flussi multimediali utilizzando l'SDK Amazon Chime](create-media-stream-pipeline.md).
Le pipeline che crei dipendono dallo spazio dei nomi che usi. Se si utilizza lo spazio dei `Chime` nomi, è possibile creare solo pipeline di acquisizione multimediale. Se utilizzate il `ChimeSdkMediaPipelines` namespace, potete anche creare pipeline di media concatenation e media live connector e utilizzare le funzionalità di composizione. Se desiderate migrare al namespace, fate riferimento a. `ChimeSdkMediaPipelines` [Migrazione allo spazio dei nomi delle pipeline multimediali di Amazon Chime SDK](migrate-pipelines.md)
# Comprensione dei limiti predefiniti per le pipeline multimediali attive di Amazon Chime SDK
La tabella seguente elenca i limiti predefiniti per le pipeline multimediali attive in ciascuna regione. Ogni tipo di pipeline conta ai fini del limite. Se superi il limite per qualsiasi regione, [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs verranno generate le [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)eccezioni **Resource Limit Exceeded**. [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)
Puoi utilizzare la pagina **Service Quotas** nella AWS console per modificare i limiti della pipeline attiva oppure puoi contattare il rappresentante dell'[assistenza clienti](https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html). Per ulteriori informazioni sui limiti delle riunioni di Amazon Chime SDK, consulta. [Quote per l'SDK Amazon Chime](meetings-sdk.md#mtg-limits)
| Region | Limite di pipeline attivo predefinito |
| --- | --- |
| us-east-1 | 100 |
| us-west-2 | 10 |
| ap-northeast-1 | 10 |
| ap-northeast-2 | 10 |
| ap-south-1 | 10 |
| ap-southeast-1 | 10 |
| ap-southeast-2 | 10 |
| ca-central-1 | 10 |
| eu-central-1 | 10 |
| eu-west-2 | 10 |
# Migrazione allo spazio dei nomi delle pipeline multimediali di Amazon Chime SDK
Puoi utilizzare lo spazio dei `ChimeSdkMediaPipelines` nomi per indirizzare gli endpoint delle API Media Pipeline in qualsiasi regione in cui sono disponibili. AWS Usa questo namespace se stai appena iniziando a utilizzare l'SDK Amazon Chime. Per ulteriori informazioni sulle regioni, consulta questa guida. [Regioni AWS disponibili per l'SDK Amazon Chime](sdk-available-regions.md)
Le applicazioni esistenti che utilizzano lo spazio dei nomi [Amazon Chime](https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime.html) devono pianificare la migrazione verso lo spazio dei nomi dedicato.
**Topics**
+ [Motivi per migrare le tue pipeline](#pipeline-migration-reasons)
+ [Prima di migrare le tue pipeline](#migration-prerequisites)
## Motivi per migrare le tue pipeline
Ti invitiamo a migrare al `ChimeSdkMediaPipelines` namespace per questi motivi:
**Scelta dell'API Endpoint**
Lo spazio dei nomi Amazon Chime SDK Media Capture è l'unico spazio dei nomi API che può utilizzare gli endpoint API in qualsiasi regione che li renda disponibili. Per ulteriori informazioni sulle regioni, consulta. [Regioni AWS disponibili per l'SDK Amazon Chime](sdk-available-regions.md) Se desideri utilizzare endpoint API diversi da`us-east-1`, devi utilizzare il `ChimeSdkMediaPipelines` namespace. Per ulteriori informazioni sugli endpoint attuali, consulta questa guida. [Mappatura delle API](migrate-from-chm-namespace.md#name-end-map)
**Pipeline multimediale nuova e aggiornata APIs**
Aggiungiamo o aggiorniamo solo la pipeline multimediale APIs nel namespace. `ChimeSdkMediaPipelines`
## Prima di migrare le tue pipeline
Prima di effettuare la migrazione, tenete presente le differenze tra i namespace. La tabella seguente li elenca e li descrive.
| Elemento | Spazio dei nomi delle pipeline multimediali | Spazio dei nomi Chime |
| --- | --- | --- |
| Nomi degli spazi dei nomi | ChimeSdkMediaPipelines | Carillon |
| Regioni | Più di uno | Solo us-east-1 |
| Endpoints | https://. media-pipelines-chime *regione .amazonaws.com* | https://service.chime.aws.amazon.com |
| Principale del servizio | mediapipelines.chime.amazonaws.com | chime.amazonaws.com |
| APIs | Solo per le pipeline multimediali APIs | APIs per pipeline multimediali e altre parti di Amazon Chime |
| Riunioni | Le pipeline multimediali nelle `eu-central-1` regioni `us-west-2``ap-southeast-1`, e funzionano solo con le riunioni create nello spazio dei nomi Amazon Chime SDK Meetings. Le pipeline multimediali della `us-east-1` regione funzionano con le riunioni create da qualsiasi endpoint di riunione in entrambi i namespace. | Le pipeline multimediali funzionano con le riunioni create da qualsiasi endpoint di riunione in entrambi i namespace. |
| Pipeline multimediali attive predefinite | 100 nella regione us-east-1 e 10 nelle regioni us-west-2, ap-southeast-1 e eu-central-1. | 100 solo in us-east-1. |
| Ruolo collegato al servizio | AWSServiceRoleForAmazonChimeSDKMediaGasdotti | |
| Tag | Disponibilità | Non disponibile per la pipeline APIs multimediale. |
| CloudTrail fonte dell'evento | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. |
| Connettore Media Live | Disponibilità | Non disponibile per la pipeline APIs multimediale. |
| Composizione | Disponibilità | Non disponibile per la pipeline APIs multimediale. |
| Concatenazione | Disponibilità | Non disponibile. |
L'elenco seguente fornisce ulteriori informazioni sulle differenze tra Chime e AWS ChimeSdkMediaPipelines i namespace.
**Nomi degli spazi dei nomi**
Lo spazio dei nomi Amazon Chime SDK utilizza il nome formale. `AWS.Chime` Lo spazio dei nomi Amazon Chime SDK Media Pipelines utilizza il nome formale. `AWS.ChimeSDKMediaPipelines` Il formato preciso del nome varia in base alla piattaforma.
Ad esempio, questa riga di codice Node.js indirizza lo `chime` spazio dei nomi:
```
const chimeMediaPipelines = AWS.Chime();
```
Per migrare allo spazio dei nomi Media Pipelines SDK, aggiorna il codice con il nuovo spazio dei nomi e l'area dell'endpoint.
```
const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });
```
**Regioni**
Lo spazio dei nomi Amazon Chime si rivolge solo agli endpoint API nella regione US-EAST-1. Lo spazio dei nomi Amazon Chime SDK Media Pipelines si rivolge agli endpoint dell'API della pipeline multimediale Amazon Chime SDK in qualsiasi regione in cui siano presenti. Per un elenco aggiornato delle regioni della pipeline multimediale, consulta questa guida. [Regioni AWS disponibili per l'SDK Amazon Chime](sdk-available-regions.md)
**Endpoints**
Per modificare una pipeline di acquisizione multimediale, è necessario utilizzare lo stesso endpoint in cui è stata creata la pipeline. Ad esempio, se hai creato pipeline tramite un endpoint in eu-central-1, devi usare eu-central-1 per interagire con quella pipeline. Per ulteriori informazioni sugli endpoint attuali, consulta questa guida. [Mappatura delle API](migrate-from-chm-namespace.md#name-end-map)
**Principale del servizio**
Lo spazio dei nomi [Amazon Chime SDK Media Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) utilizza un nuovo service principal:. `mediapipelines.chime.amazonaws.com` Se disponi di bucket Amazon S3 o di altre policy IAM che garantiscono l'accesso ai servizi, devi aggiornare tali policy per concedere l'accesso al nuovo service principal.
Ad esempio, quando crei una pipeline multimediale, devi aggiungere le autorizzazioni di policy elencate nella [Creazione di un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](create-s3-bucket.md) nuova entità del servizio. Per ulteriori informazioni sulle policy, consulta [AWS JSON Policy elements: Principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) nella IAM User Guide.
**APIs**
Lo spazio dei nomi Amazon Chime SDK Media Pipelines contiene APIs solo le pipeline di creazione e gestione delle pipeline multimediali. Lo spazio dei nomi Amazon Chime include APIs pipeline multimediali, riunioni e altre parti del servizio Amazon Chime.
**Riunioni**
Le pipeline multimediali nella regione IAD funzionano con le riunioni create da qualsiasi endpoint di riunione con entrambi i namespace.
**Ruolo collegato al servizio**
Solo per lo spazio dei nomi Amazon Chime SDK Media Pipelines. *Crea il ruolo Pipelines. AWSService RoleForAmazonChime SDKMedia*
**Tag**
Lo spazio dei [nomi Amazon Chime SDK Media Pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) supporta i tag. Il ruolo deve essere autorizzato a chiamare l'`TagResource`operazione quando chiama [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)o [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs con uno o più tag.
# Informazioni sulla creazione di pipeline multimediali con Amazon Chime SDK
Segui un processo in più fasi per creare una pipeline multimediale Amazon Chime SDK e puoi creare diversi tipi di pipeline. L'elenco seguente descrive il processo di creazione e fornisce collegamenti a ulteriori informazioni sulla creazione dei vari tipi di pipeline.
+ Creare un bucket Amazon S3. È necessario creare il bucket nella stessa AWS regione della riunione. Per ulteriori informazioni, vedi [Creazione di un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](create-s3-bucket.md).
+ Crea un ruolo collegato al servizio denominato. `AWSServiceRoleForAmazonChimeSDKMediaPipelines` Ciò consente alle pipeline multimediali di accedere alle riunioni per tuo conto. Per ulteriori informazioni, vedi [Creazione di un ruolo collegato ai servizi per le pipeline multimediali di Amazon Chime SDK](create-pipeline-role.md).
+ Crea un ruolo IAM con autorizzazioni sufficienti per interagire con la pipeline [multimediale di Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html). APIs Per creare quel ruolo, consigliamo di aggiungere la policy gestita dall'[AmazonChimeSDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) dalla console IAM. La policy contiene quanto necessario APIs.
Il tuo ruolo IAM deve inoltre avere l'autorizzazione a chiamare l'[https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html)API Amazon S3 su tutte le risorse. L'esempio seguente mostra una politica tipica per farlo.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": "s3:GetBucketPolicy",
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Una volta ottenuti questi elementi, consultate questi argomenti per informazioni sulla creazione di pipeline.
+ [Creazione di pipeline di acquisizione multimediale per le riunioni dell'SDK Amazon Chime](capture-pipe-config.md)
+ [Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime](create-concat-pipe.md)
+ [Creazione di pipeline di connettori multimediali live per le riunioni dell'SDK Amazon Chime](connector-pipe-config.md)
+ [Creazione di pipeline di flussi multimediali utilizzando l'SDK Amazon Chime](create-media-stream-pipeline.md)
# 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)
# Creazione di pipeline di concatenazione multimediale per le riunioni dell'SDK Amazon Chime
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
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
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
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.*
# Creazione di pipeline di connettori multimediali live per le riunioni dell'SDK Amazon Chime
Le sezioni seguenti elencano e descrivono il Real-Time Messaging Protocol (RTMP), le impostazioni audio e video per una pipeline di connettori multimediali live.
**Impostazioni RTMP**
Le pipeline Media Live Connector supportano RTMP tramite una connessione. TLS/SSL L'URL sink è composto dall'URL dello stream e dalla chiave dello stream. URLs Segui questo formato:
`rtmp(s)://stream-server/stream-key`
Gli esempi seguenti mostrano come connettersi a piattaforme di streaming comuni.
+ **Amazon Interactive Video Service (IVS)** — rtmps: //a1b2c3d4e5f6.global-contribute.live-video.net:443/app/ *IVS-stream-key*
+ **YouTube**— rtmp: //a.youtube.com/live2/ *stream-key*
+ **Twitch —** rtmps: //live.twitch.tv/app/ *primary-stream-key*
**Importante**
RTMPS utilizza la crittografia per garantire che uno stream non venga intercettato da un'entità non autorizzata. Come best practice, usa RTMPS quando hai bisogno di una maggiore sicurezza dei dati.
**Impostazioni audio**
Le pipeline dei connettori Media Live supportano le seguenti impostazioni audio:
+ **Codec: AAC**
+ **Frequenza di campionamento**: 44100 Hz o 48000 Hz. L'impostazione predefinita è 44100 Hz.
+ **Canali**: mono o stereo. L'impostazione predefinita è mono.
**Impostazioni video**
Le pipeline di connettori Media Live utilizzano l'encoder H264. È possibile utilizzare HD a 1280x720 o FHD a 1920x1080. Entrambe le risoluzioni utilizzano 30 fotogrammi al secondo, con un fotogramma chiave ogni due secondi.
**Interruzione delle pipeline di Media Live Connector**
Come procedura consigliata per interrompere le pipeline di Media Live Connector, chiamate l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) L'interruzione di uno streaming su una piattaforma di streaming come IVS non interrompe una pipeline di media live connector.
# Creazione di pipeline di flussi multimediali utilizzando l'SDK Amazon Chime
Le pipeline di streaming multimediali acquisiscono l'audio individuale per tutti i partecipanti a una riunione, oltre all'audio misto generato da una pipeline di concatenazione multimediale. Tutte le pipeline di flussi multimediali salvano i dati in [Amazon Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html) Streams (KVS).
Puoi creare il flusso video chiamando l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html) Puoi creare una pipeline di flussi multimediali per riunione Amazon Chime SDK.
**Nota**
Se una riunione utilizza una regione di attivazione come regione [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion), il flusso KVS deve trovarsi nella stessa regione. Ad esempio, se una riunione utilizza la `af-south-1` regione, deve essere presente anche lo stream KVS. `af-south-1` Tuttavia, se la riunione utilizza una regione che AWS attiva per impostazione predefinita, lo stream KVS può trovarsi in qualsiasi regione disponibile, inclusa una regione opt-in. Ad esempio, se la riunione utilizza`ca-central-1`, lo stream KVS può trovarsi in`eu-west-2`, `us-east-1``af-south-1`, o in qualsiasi altra regione supportata dall'SDK Amazon Chime.
Per sapere quale AWS regione viene utilizzata da una riunione, chiama l'[GetMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_GetMeeting.html)API e utilizza il [MediaRegion](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html#chimesdk-meeting-chime_CreateMeeting-request-MediaRegion)parametro della risposta.
Per ulteriori informazioni sulle regioni che hanno aderito all'[Regioni AWS disponibili per l'SDK Amazon Chime](sdk-available-regions.md)account, consulta questa guida e [specifica quali AWS regioni possono essere utilizzate dal tuo account](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#rande-manage-enable.html) nella *Guida di riferimento per la gestione degli AWS account*.
Le seguenti sezioni spiegano come creare una pipeline di flussi multimediali. Seguili nell’ordine in cui sono elencati.
**Topics**
+ [Creazione di un pool Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK](create-kvs-pool.md)
+ [Codice di esempio per i pool Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK](pool-creation-code.md)
+ [Creazione di pipeline di flussi multimediali per Amazon Chime SDK](create-stream-pipeline.md)
+ [Codice di esempio per le pipeline di flussi multimediali di Amazon Chime SDK](pipeline-creation-code.md)
+ [Utilizzo delle notifiche di Event Bridge per le pipeline di flussi multimediali di Amazon Chime SDK](media-stream-event-bridge.md)
+ [Utilizzo dei dati delle pipeline di streaming multimediale di Amazon Chime SDK](media-stream-tips-tricks.md)
# Creazione di un pool Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK
Il pool Kinesis Video Streams (KVS) per la pipeline di flussi multimediali deve appartenere allo stesso account AWS della riunione Amazon Chime SDK. Puoi creare un pool Kinesis Video Streams chiamando [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)l'API.
Il diagramma seguente mostra l'architettura di un pool Kinesis Video Streams di una pipeline multimediale. I numeri nell'immagine corrispondono al testo numerato riportato di seguito:
![\[Diagramma che mostra una chiamata API che crea un pool Kinesis Video Streams.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/media-stream-pool-architecture.png)
Nel diagramma:
1. Chiamate l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)API.
1. Il piano di controllo della pipeline multimediale crea e gestisce Kinesis Video Streams (KVS) e il pool per tuo conto nel tuo account.
Il funzionamento del pool KVS, il processo di creazione, aggiornamento ed eliminazione dei flussi nel pool, è asincrono. Di conseguenza, le notifiche di Event Bridge utilizzano il tipo di `Chime Media Pipeline Kinesis Video Pool State Change` dettaglio per comunicare lo stato degli stream in un pool.
È possibile creare un pool una sola volta e riutilizzarlo in riunioni diverse. Puoi anche creare diversi pool in base alle esigenze ed eliminare i pool quando non ne hai bisogno.
I pool si ridimensionano automaticamente, in base al numero di chiamate simultanee. È possibile eliminare tutti i pool non necessari.
**Nota**
Quando si elimina un pool, è necessario attendere che il pool venga eliminato completamente prima di eliminare i flussi KVS presenti nel pool. Una notifica di Event Bridge indicherà quando il pool è stato completamente eliminato. Ciò accade dopo che tutte le riunioni che utilizzano il pool sono terminate. Puoi anche chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html)API per visualizzare le `PoolId` informazioni relative a un determinato pool KVS.
Quando richiami l'API Kinesis Video [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)Streams, puoi utilizzare quella stringa di denominazione per cercare ed eliminare gli stream in un pool. Puoi anche chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipelineKinesisVideoStreamPool.html)API per visualizzare il relativo pool KVS. `PoolId` Gli esempi nella prossima sezione spiegano come fare.
# Codice di esempio per i pool Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK
Gli esempi seguenti mostrano come creare, aggiornare, ottenere, elencare ed eliminare i pool Kinesis Video Streams (KVS). Espandi ogni sezione per ottenere ulteriori informazioni.
## Importazioni e variabili comuni
```
'''
Define imports and common variables
'''
import boto3
from uuid import uuid4
import json
client = boto3.client("chime-sdk-media-pipelines", region_name='us-east-1')
pool_name = 'MyDemoKvsPool'
def pretty_print_json(obj):
print(json.dumps(obj, default=str, indent=4))
```
## CreateMediaPipelineKinesisVideoStreamPool
```
response = client.create_media_pipeline_kinesis_video_stream_pool(
StreamConfiguration={
'Region': 'us-east-1',
'DataRetentionInHours': 24
},
PoolName=pool_name,
ClientRequestToken=str(uuid4()),
Tags=[
{
'Key': 'MyTagForAccessControl',
'Value': 'SomeTagValue'
},
]
)
pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```
**Output:**
```
{
"PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
"PoolName": "MyDemoKvsPool",
"PoolId": "ChimeMediaPipelines-MyDemoKvsPool-1f4e1a69-e718-4884-bf92-8a393ac0405b",
"PoolStatus": "CREATING",
"StreamConfiguration": {
"Region": "us-east-1",
"DataRetentionInHours": 24
},
"CreatedTimestamp": "2023-10-13 01:26:09.979000+00:00",
"UpdatedTimestamp": "2023-10-13 01:26:09.979000+00:00"
}
```
## GetMediaPipelineKinesisVideoStream
```
response = client.get_media_pipeline_kinesis_video_stream_pool(
Identifier=pool_name
)
pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```
**Output:**
```
{
"PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
"PoolName": "MyDemoKvsPool",
"PoolId": "ChimeMediaPipelines-MyDemoKvsPool-1f4e1a69-e718-4884-bf92-8a393ac0405b",
"PoolStatus": "ACTIVE",
"StreamConfiguration": {
"Region": "us-east-1",
"DataRetentionInHours": 24
},
"CreatedTimestamp": "2023-10-13 01:26:09.979000+00:00",
"UpdatedTimestamp": "2023-10-13 01:26:09.979000+00:00"
}
```
## UpdateMediaPipelineKinesisVideoStream
```
response = client.update_media_pipeline_kinesis_video_stream_pool(
Identifier=pool_name,
StreamConfiguration={
'DataRetentionInHours': 48
}
)
pretty_print_json(response['KinesisVideoStreamPoolConfiguration'])
```
**Output:**
```
{
"PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool",
"PoolName": "MyDemoKvsPool",
"PoolId": "ChimeMediaPipelines-MyDemoKvsPool-d08c26ae-0336-4e2e-acdf-805a7d71b891",
"PoolStatus": "UPDATING",
"PoolSize": 40,
"StreamConfiguration": {
"Region": "us-east-1",
"DataRetentionInHours": 48
},
"CreatedTimestamp": "2023-10-13 01:44:23.010000+00:00",
"UpdatedTimestamp": "2023-10-13 01:44:28.486000+00:00"
}
```
## ListMediaPipelineKinesisVideoStream
```
list_of_pools = []
max_results = 100
next_token = None
while(True):
if next_token:
response = client.list_media_pipeline_kinesis_video_stream_pools(
NextToken=next_token,
MaxResults=max_results
)
else:
response = client.list_media_pipeline_kinesis_video_stream_pools(
MaxResults=max_results
)
list_of_pools.extend(response['KinesisVideoStreamPools'])
next_token = response.get('NextToken')
if not next_token:
break
pretty_print_json(list_of_pools)
```
**Output:**
```
[
{
"PoolName": "MyDemoKvsPool",
"PoolId": "ChimeMediaPipelines-MyDemoKvsPool-6588e703-f046-4288-ba7f-0c03de76a6bb",
"PoolArn": "arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/MyDemoKvsPool"
}
]
```
## DeleteMediaPipelineKinesisVideoStream
```
client.delete_media_pipeline_kinesis_video_stream_pool(
Identifier=pool_name
)
```
**Output**: una `delete_media_pipeline_kinesis_video_stream_pool` richiesta riuscita non ha un corpo.
# Creazione di pipeline di flussi multimediali per Amazon Chime SDK
La pipeline del flusso multimediale chime deve appartenere allo stesso AWS account della riunione Amazon Chime SDK. Puoi creare la pipeline di flussi multimediali di Amazon Chime SDK chiamando l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API e specificando una fonte e un sink.
Il diagramma seguente mostra l'architettura di una pipeline di flussi multimediali di Amazon Chime SDK. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.
![\[Diagramma che mostra una chiamata API che crea un pool di flussi multimediali.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)
Nel diagramma:
1. Chiamate l'`CreateMediaStreamPipeline`API. Nella richiesta, specificate le sorgenti e i sink per gli stream, indipendentemente dal fatto che vogliate acquisire audio singolo, audio misto o entrambi. Includi l'ARN del tuo pool KVS nella richiesta.
+ L'array dei sorgenti è composto da e. `SourceType` `SourceArn` È necessario utilizzare il`ChimeSdkMeeting SourceType`. `SourceArn`È l'ARN di. `ChimeSdkMeeting`
+ L'array dei sinks è composto da`SinkType`, `SinkArn``ReservedStreamCapacity`, e. `MediaStreamType` Supportiamo solo il. `KinesisVideoStreamPoolSinkType` `SinkArn`È l'ARN di. `KinesisVideoStreamPool` `MediaStreamType`Controlla il tipo di file multimediale trasmesso al sink, o`MixedAudio`. `IndividualAudio` `ReservedStreamCapacity`imposta il numero di stream allocati per il `MediaStreamType` from. `KinesisVideoStreamPool`
+ Se vuoi eseguire lo streaming di entrambi `IndividualAudio` e`MixedAudio`, crea due oggetti sink nell'`Sinks`array, uno per`IndividualAudio`, l'altro per. `MixedAudio` L'`SinkArn`(l'ARN del`KinesisVideoStreamPool`) può variare per ogni lavello.
+ Per trasmettere solo audio singolo o audio misto, create un oggetto sink con quello desiderato`MediaStreamType`.
+ Tenere presente quanto segue:
+ Quando si richiama l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API con `KinesisVideoStreamPool` as the`SinkType`, `SinkARN` deve appartenere alla regione del piano di controllo in cui `CreateMediaStreamPipeline` viene richiamata.
Ad esempio, se create una pipeline di flussi multimediali in`us-east-1`, dovete utilizzare un in. `KinesisVideoStreamPool` `us-east-1`
+ `ReservedStreamCapacity`dovrebbe essere **1** quando si specifica il `MixedAudio``MediaStreamType`, e tra **1-10** quando si specifica il `IndividualAudio``MediaStreamType`.
1. Il piano dati della pipeline multimediale richiama l'[ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)API KVS per memorizzare l'audio individuale in un flusso KVS che appartiene al pool KVS specificato.
1. Il piano dati della pipeline multimediale richiama l'`PutMedia`API KVS per memorizzare l'audio misto in un flusso che appartiene al pool KVS specificato.
**Nota**
Dopo aver chiamato l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html)API, i builder possono utilizzare gli [eventi della pipeline multimediale](media-pipe-events.md) o chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html)API per determinare se lo stato della pipeline è. `InProgress`
Una volta raggiunto lo stato della pipeline, i file multimediali`InProgress`, qualsiasi combinazione di e, vengono trasmessi a KVS. `IndividualAudio` `MixedAudio`
Per il tipo di `IndividualAudio` stream, esiste una mappatura 1:1 tra il partecipante e il flusso KVS allocato da. IDs `KinesisVideoStreamPool` La mappatura si applica per tutta la durata della pipeline multimediale.
Per sapere a quale stream KVS è associato o a quale ID partecipante è assegnato MixedAudio, utilizzate una delle seguenti tecniche:
Usa le notifiche di [Event Bridge](media-stream-event-bridge.md). Ogni notifica fornisce informazioni come il partecipante IDs e il KVS ARN che trasmette l'audio del partecipante. Quando inizia una sessione `IndividualAudio` di `MixedAudio` streaming, inviamo un evento. `chime:MediaPipelineKinesisVideoStreamStart` Le sessioni di streaming terminano quando un partecipante abbandona la chiamata (per`IndividualAudio`) o al termine della riunione.
Usa i metadati persistenti che Kinesis Video Streams inviano con ogni frammento. I metadati contengono informazioni simili a quelle inviate da Event Bridge. I builder devono analizzare tutti gli stream di `KinesisVideoStreamPool` specificando il nome del pool come prefisso nell'API Kinesis Video [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)Streams utilizzando questa soluzione.
La chiusura della pipeline Media Stream avviene quando la riunione viene eliminata o l'API viene richiamata per quella pipeline di flusso multimediale. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) Viene inoltre inviata una [notifica di Event Bridge](media-pipe-events.md) per indicare la chiusura della pipeline multimediale.
# Codice di esempio per le pipeline di flussi multimediali di Amazon Chime SDK
Gli esempi seguenti mostrano come creare pipeline di flussi multimediali per audio misto, audio individuale ed entrambi. Espandi ogni sezione per ottenere ulteriori informazioni.
## CreateMediaStreamPipelineper audio misto
```
response = client.create_media_stream_pipeline(
Sources=[
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
Sinks=[
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 1,
'MediaStreamType': 'MixedAudio'
},
],
ClientRequestToken='sample token',
Tags=[
{
'Key': 'sample key',
'Value': 'sample value'
},
]
)
```
**Risposta:**
```
{
'MediaStreamPipeline': {
'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
'Status': 'Initializing',
'Sources': [
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
'Sinks': [
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 1,
'MediaStreamType': 'MixedAudio'
},
]
}
}
```
## CreateMediaStreamPipelineper audio individuale
```
response = client.create_media_stream_pipeline(
Sources=[
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
Sinks=[
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 5,
'MediaStreamType': 'IndividualAudio'
},
],
ClientRequestToken='sample token',
Tags=[
{
'Key': 'sample key',
'Value': 'sample value'
},
]
)
```
**Risposta:**
```
{
'MediaStreamPipeline': {
'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
'Status': 'Initializing',
'Sources': [
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
'Sinks': [
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 5,
'MediaStreamType': 'IndividualAudio'
},
]
}
}
```
## CreateMediaStreamPipelineper audio misto e individuale
```
response = client.create_media_stream_pipeline(
Sources=[
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
Sinks=[
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 1,
'MediaStreamType': 'MixedAudio'
},
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 5,
'MediaStreamType': 'IndividualAudio'
},
],
ClientRequestToken='sample token',
Tags=[
{
'Key': 'sample key',
'Value': 'sample value'
},
]
)
```
**Risposta:**
```
{
'MediaStreamPipeline': {
'MediaPipelineId': '45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'MediaPipelineArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline/45bc79a0-4591-4ebe-a642-d42c4e279f2d',
'CreatedTimestamp': '2023-07-25T21:48:48.265Z',
'UpdatedTimestamp': '2023-07-25T21:48:48.376Z',
'Status': 'Initializing',
'Sources': [
{
'SourceType': 'ChimeSdkMeeting',
'SourceArn': 'arn:aws:chime:us-east-1:account-ID:meeting/bed804cf-8cf0-4991-9b8d-d1acc2987433'
},
],
'Sinks': [
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 1,
'MediaStreamType': 'MixedAudio'
},
{
'SinkArn': 'arn:aws:chime:us-east-1:account-ID:media-pipeline-kinesis-video-stream-pool/foo',
'SinkType': 'KinesisVideoStreamPool',
'ReservedStreamCapacity': 5,
'MediaStreamType': 'IndividualAudio'
},
]
}
}
```
# Utilizzo delle notifiche di Event Bridge per le pipeline di flussi multimediali di Amazon Chime SDK
Inoltre[Utilizzo degli eventi della pipeline multimediale di Amazon Chime SDK](media-pipe-events.md), le pipeline di flussi multimediali inviano notifiche a Event Bridge quando avviano e interrompono lo streaming su KVS e quando lo stato del pool video cambia.
**Topics**
+ [Informazioni sugli eventi della pipeline dei flussi multimediali di Amazon Chime SDK](stream-pipe-events.md)
+ [Informazioni sugli eventi del pool di Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK](media-stream-pool-events.md)
# Informazioni sugli eventi della pipeline dei flussi multimediali di Amazon Chime SDK
Le pipeline di flussi multimediali inviano i seguenti eventi. Espandi ogni sezione per ottenere ulteriori informazioni.
## Avvio dello streaming video di Amazon Chime Media Stream Pipeline Kinesis
La pipeline multimediale Amazon Chime SDK invia questo evento quando la pipeline del flusso multimediale inizia a ricevere l'audio dalla riunione e lo trasmette a KVS. `ExternalUserId`I campi vuoti `AttendeeId` e indicano che la pipeline multimediale ha inviato audio misto allo stream KVS.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamStart",
"timestamp": 1627503649251,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1",
"attendeeId": "Attendee_Id",
"externalUserId": "External_User_Id",
"kinesisVideoStreamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/Chime*",
"startFragmentNumber": "1234567899444",
"startTime": "yyyy-mm-ddThh:mm:ssZ"
}
}
```
## Fine dello streaming video di Amazon Chime Media Stream Pipeline Kinesis
La pipeline multimediale invia questo evento a Event Bridge quando termina lo streaming su KVS.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamEnd",
"timestamp": 1627503649251,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1",
"attendeeId": "Attendee_Id",
"externalUserId": "External_User_Id",
"kinesisVideoStreamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/Chime*",
"startFragmentNumber": "1234567899444",
"startTime": "yyyy-mm-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ",
"endFragmentNumber": "1234567899555"
}
}
```
# Informazioni sugli eventi del pool di Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK
Le pipeline multimediali inviano i seguenti eventi a Event Bridge quando lo stato dei pool cambia. Espandi ogni sezione per ottenere ulteriori informazioni.
## Pool video Kinesis di Amazon Chime Media Pipeline attivo
La pipeline multimediale invia questo evento dopo che l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaPipelineKinesisVideoStreamPool.html)API ha creato un pool.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolActive",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
## Aggiornamento del pool video Kinesis di Amazon Chime Chime Media Pipeline
La pipeline multimediale invia questo evento dopo che l'API ha aggiornato un pool. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaPipelineKinesisVideoStreamPool.html)
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolUpdated",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
## Eliminato il pool video Kinesis di Amazon Chime Media Pipeline
La pipeline multimediale invia questo evento a Event Bridge quando elimina un pool. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipelineKinesisVideoStreamPool.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipelineKinesisVideoStreamPool.html)
Per ulteriori informazioni sull'eliminazione dei pool, fare riferimento a[Creazione di un pool Kinesis Video Streams per le pipeline di flussi multimediali di Amazon Chime SDK](create-kvs-pool.md), in questa sezione.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolDeleted",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
## Errore temporaneo del pool video Kinesis di Amazon Chime Media Pipeline
La pipeline multimediale invia il seguente evento a Event Bridge quando un pool video si guasta temporaneamente.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolTemporaryFailure",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
## Errore permanente del pool video Kinesis di Amazon Chime Media Pipeline
La pipeline multimediale invia il seguente evento a Event Bridge in caso di guasto permanente di un pool video.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolPermanentFailure",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
Riceverai il seguente evento di pipeline multimediale aggiuntivo se il tuo account AWS ha superato il limite di streaming video di Amazon Kinesis.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline Kinesis Video Pool State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"eventType": "chime:MediaPipelineKinesisVideoStreamPoolStreamLimitExceeded",
"timestamp": 1627503649251,
"mediaRegion": "ap-southeast-1",
"poolArn" : "ARN of the KVS Pool"
}
}
```
# Utilizzo dei dati delle pipeline di streaming multimediale di Amazon Chime SDK
Puoi utilizzare i metadati nelle notifiche per ottenere KVS ARNs, numeri di frammenti e timestamp dei frammenti. Queste informazioni possono aiutarti a elaborare i dati audio in uno stream KVS.
Inoltre, puoi usare KVS ARNs con KVS APIs per leggere i dati da un flusso. A seconda del caso d'uso, si chiama and. [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html) APIs In genere, una `GetMediaForFragmentList` chiamata è preceduta da una chiamata all'[https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_ListFragments.html)API. Per ulteriori informazioni, consulta [Lettura dei dati dagli stream](https://aws.amazon.com/kinesis/video-streams/faqs/), in *Amazon Kinesis Video* Streams. FAQs
A seconda del caso d'uso, i builder possono utilizzare la libreria di parser Kinesis Video Streams, che a sua volta utilizza l'API KVS. [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html)
Le pipeline di flussi multimediali aggiungono i seguenti metadati delle riunioni e dei partecipanti a ciascun frammento.
```
"meetingId"
"externalMeetingId"
"attendeeId"
"externalUserId"
"sampleRate"
"channels"
```
I dati multimediali vengono archiviati in formato MKV. Tutti i dati audio MKV sono codificati in AAC. Per ulteriori informazioni, consulta il modello di dati di [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-data.html), *nella Kinesis Video Streams* Developer Guide.
# Composizione di audio e video in un'unica visualizzazione nelle riunioni dell'SDK Amazon Chime
Le pipeline multimediali di Amazon Chime SDK supportano la composizione di audio, video di webcam e flussi video per la condivisione di contenuti in un'unica visualizzazione. Puoi quindi utilizzare live connector per inviare quella singola visualizzazione a servizi di streaming come Amazon Interactive Video Service, Twitch o YouTube Live. I video compositi possono anche essere acquisiti su Amazon Simple Storage Service per l'archiviazione o l'ulteriore utilizzo.
La composizione utilizza un layout di schermo predefinito chiamato`GridView`, che presenta i seguenti comportamenti.
+ Quando sono attivi solo i video della webcam, `GridView` organizza gli stream secondo il seguente schema a griglia:
![\[Una griglia a quattro colonne e quattro righe che mostra i contorni delle persone.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/grid-no-content-share.png)
La griglia mostra un massimo di 25 stream di webcam e ordina i riquadri in base al momento in cui gli utenti accendono le videocamere.
+ `GridView`fornisce due orientamenti della tela e. `Landscape` `Portrait` Landscape, l'orientamento predefinito, supporta risoluzioni video di 1280x720 e 1920x1080 per FHD. Portrait supporta risoluzioni di 720x1280 e 1080x1920 per FHD.
+ È possibile configurare l'ordine, la posizione, il numero totale, le proporzioni dei riquadri, il raggio degli angoli, il colore del bordo, lo spessore del bordo e il colore di evidenziazione dei riquadri video.
+ Durante una riunione, quando qualcuno condivide lo schermo, i riquadri video della webcam si spostano dinamicamente per lasciare spazio alla condivisione dei contenuti. È possibile controllare tali transizioni e le posizioni dei riquadri video utilizzando una delle configurazioni di layout descritte nella sezione successiva.
**Informazioni sulle configurazioni del layout**
Quando qualcuno avvia una condivisione di contenuti, puoi scegliere come comporre la condivisione di contenuti e i flussi video della webcam utilizzando una delle seguenti configurazioni di layout.
+ `ActiveSpeakerOnlyConfiguration`compone il video dei contenuti a schermo intero, con il video della webcam del relatore attivo sovrapposto in un angolo. È possibile specificare l'angolo.
+ `PresenterOnlyConfiguration`compone il video dei contenuti a schermo intero, con il video della webcam del relatore sovrapposto in un angolo. È possibile specificare l'angolo.
+ `VerticalLayoutConfiguration`compone il contenuto video con il video della webcam in una colonna verticale adiacente. È possibile visualizzare la colonna a destra o a sinistra della condivisione di contenuti.
+ `HorizontalLayoutConfiguration`compone il contenuto video con il video della webcam in una riga orizzontale adiacente. È possibile visualizzare la riga sopra o sotto la condivisione di contenuti.
I layout compositi passano automaticamente da un layout all'altro`GridView`, a seconda che la condivisione dei contenuti sia attiva o meno.
I seguenti argomenti spiegano come utilizzare le `GridView` impostazioni globali e ogni layout di configurazione.
**Topics**
+ [Impostazione dell'orientamento della tela per la composizione nelle riunioni dell'SDK Amazon Chime](canvas-orientation.md)
+ [Impostazione degli attributi dei bordi e degli angoli per la composizione nelle riunioni dell'SDK Amazon Chime](video-attribute.md)
+ [Utilizzo delle configurazioni di layout per la composizione nelle riunioni dell'SDK Amazon Chime](compositing-layouts.md)
# Impostazione dell'orientamento della tela per la composizione nelle riunioni dell'SDK Amazon Chime
Durante la composizione, l'area di *disegno* contiene tutti i tuoi flussi video. È possibile specificare un `Portrait` orientamento `Landscape` o per l'area di disegno. Landscape fornisce un rapporto di aspetto 16:9. Portrait offre un rapporto d'aspetto di 9:16.
L'immagine seguente mostra l'orientamento del ritratto.
![\[Immagine che mostra due riquadri video in una finestra verticale (verticale).\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-portrait-with-tile.png)
L'esempio seguente mostra come implementare una tela verticale con il riquadro video nell'angolo in alto a destra. In questo esempio, l'altoparlante attivo appare nel riquadro. Per ulteriori informazioni, consulta [ActiveSpeakerOnlyConfiguration](compositing-layouts.md#active-speaker-only)
```
{
"CompositedVideo":{
"Layout":"GridView",
"Resolution":"FHD",
"GridViewConfiguration":{
"ContentShareLayout":"ActiveSpeakerOnly",
"ActiveSpeakerOnlyConfiguration":{
"ActiveSpeakerPosition":"TopRight"
}
},
"CanvasOrientation": "Portrait"
}
}
```
L'immagine seguente mostra l'orientamento del paesaggio.
![\[Immagine che mostra due riquadri video in una finestra orizzontale (orizzontale).\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-landscape-with-tile.png)
**CanvasOrientation**
*Descrizione*: l'impostazione dell'orientamento, Orizzontale o Ritratto.
*Valori consentiti* — `Landscape` \$1 `Portrait`
*Obbligatorio*: no
*Impostazione predefinita*: Paesaggio
# Impostazione degli attributi dei bordi e degli angoli per la composizione nelle riunioni dell'SDK Amazon Chime
Se lo desiderate, potete utilizzare il `VideoAttribute` parametro per specificare le impostazioni dei bordi e degli angoli per i riquadri video. È possibile specificare colori, larghezze e angoli arrotondati. Puoi anche specificare un colore di evidenziazione e il bordo assume quel colore quando qualcuno parla.
Le impostazioni degli attributi si applicano a tutti i layout, indipendentemente dalla condivisione dei contenuti.
L'immagine seguente mostra un riquadro video con un colore del bordo e un raggio d'angolo applicati.
![\[Immagine di una schermata condivisa e di un riquadro video con bordo rosso e angoli arrotondati.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-speaker-border.png)
L'esempio seguente mostra come utilizzare ogni attributo. In questo caso, i riquadri video hanno angoli arrotondati con un raggio di cinque pixel. I riquadri hanno un bordo verde, anch'esso largo cinque pixel. Quando l'oratore parla, l'`HighlightColor`attributo cambia il colore del bordo in rosso.
```
{
"CompositedVideo":{
"Layout":"GridView",
"Resolution":"FHD",
"GridViewConfiguration":{
"ContentShareLayout":"ActiveSpeakerOnly",
"ActiveSpeakerOnlyConfiguration":{
"ActiveSpeakerPosition":"TopRight"
}
"VideoAttribute": {
"CornerRadius" : 10,
"BorderColor" : "Green",
"HighlightColor" : "Red",
"BorderThickness": 5
},
}
}
}
```
**VideoAttribute**
*Descrizione*: specifica le impostazioni per i bordi dei riquadri video e gli angoli arrotondati
*Valori consentiti* — `BorderColor` \$1 \$1 `BorderThickness` \$1 `CornerRadius` `HighlightColor`
*Obbligatorio*: no
**VideoAttribute.BorderColor**
*Descrizione*: definisce il colore del bordo per tutti i riquadri video
*Valori consentiti*: nomi di colori, ad esempio rosso, verde o blu
*Obbligatorio*: no
**VideoAttribute.BorderThickness**
*Descrizione*: definisce lo spessore del bordo in pixel per tutti i riquadri video
*Tipo*: numero intero
*Valori consentiti*: 1—20
*Obbligatorio*: no
**VideoAttribute.CornerRadius**
*Descrizione*: definisce il raggio dell'angolo in pixel per tutti i riquadri video.
*Tipo*: numero intero
*Valori consentiti*: 1—20
*Obbligatorio*: no
**VideoAttribute.HighlightColor**
*Descrizione*: definisce il colore del bordo che appare quando un relatore o un oratore parla
*Valori consentiti*: nomi di colori, ad esempio rosso, verde o blu
*Obbligatorio*: no
# Utilizzo delle configurazioni di layout per la composizione nelle riunioni dell'SDK Amazon Chime
I seguenti argomenti spiegano come utilizzare i diversi layout di configurazione. I layout hanno effetto solo quando qualcuno avvia una condivisione di contenuti. Espandi ogni sezione per ottenere ulteriori informazioni.
## ActiveSpeakerOnlyConfiguration
`ActiveSpeakerOnlyConfiguration`visualizza la condivisione di contenuti e il video del relatore attivo, il che significa che la persona che sta parlando appare nel piccolo riquadro video che si sovrappone allo stream di condivisione dei contenuti.
L'immagine seguente mostra la configurazione e le posizioni disponibili per il riquadro degli altoparlanti.
![\[Immagine che mostra un riquadro video grande al centro di una finestra e un riquadro piccolo in alto a sinistra.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-active-speaker-4x.png)
L'esempio seguente mostra come implementare il layout a livello di codice. `ActiveSpeakerOnly` In questo caso, il riquadro del presentatore viene visualizzato nell'angolo superiore sinistro.
```
{
"CompositedVideo":{
"Layout":"GridView",
"Resolution":"FHD",
"GridViewConfiguration":{
"ContentShareLayout":"ActiveSpeakerOnly",
"ActiveSpeakerOnlyConfiguration":{
"ActiveSpeakerPosition":"TopLeft"
}
}
}
}
```
**ActiveSpeakerOnlyConfiguration**
*Descrizione*: le impostazioni di configurazione per un riquadro video `ActiveSpeakerOnly`
*Tipo*: ActiveSpeakerOnlyConfiguration oggetto
*Obbligatorio*: no
**ActiveSpeakerOnlyConfiguration.ActiveSpeakerPosition**
*Descrizione*: la posizione del riquadro video dell'altoparlante attivo
*Tipo*: stringa
*Valori validi* — `TopLeft` \$1 `TopRight` \$1 `BottomLeft` \$1 `BottomRight`
*Obbligatorio*: no
*Impostazione predefinita*: `TopRight`
## PresenterOnlyConfiguration
`PresenterOnlyConfiguration`visualizza la condivisione dei contenuti e solo il video del relatore indipendentemente da chi parla. L'immagine seguente mostra la configurazione.
![\[Immagine di quattro schermate. Ogni schermata presenta una finestra di condivisione al centro e un riquadro video in ogni angolo.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-presenter-only-4x.png)
L'esempio seguente mostra come implementare il layout a livello di codice con il relatore in alto a destra.
```
{
"CompositedVideo": {
"Layout": "GridView",
"Resolution": "FHD",
"GridViewConfiguration": {
"ContentShareLayout": "PresenterOnly",
"PresenterOnlyConfiguration": {
"PresenterPosition": "TopRight"
}
}
}
}
```
**PresenterOnlyConfiguration**
*Descrizione*: le impostazioni di configurazione per un layout `PresenterOnly`
*Tipo*: `PresenterOnlyConfiguration` oggetto
*Obbligatorio*: no
**PresenterOnlyConfiguration.PresenterPosition**
*Descrizione*: la posizione del riquadro video del presentatore
*Tipo*: stringa
*Valori validi* — `TopLeft` \$1 \$1 `TopRight` \$1 `BottomLeft` `BottomRight`
*Obbligatorio*: no
*Impostazione predefinita*: `TopRight`
## HorizontalLayoutConfiguration
`HorizontalLayoutConfiguration`visualizza la condivisione dei contenuti e i flussi video in orizzontale. Puoi utilizzare l'`TilePosition`impostazione per visualizzare i riquadri sopra o sotto lo stream di condivisione dei contenuti. I relatori vengono sempre visualizzati a sinistra. I riquadri aggiuntivi vengono visualizzati nell'ordine stabilito da. `JoinSequence`
L'immagine seguente mostra i riquadri sotto lo stream di condivisione dei contenuti.
![\[Immagine che mostra un riquadro centrale grande e 4 riquadri più piccoli in una riga sottostante.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/compositing-horizontal-bottom.png)
L'esempio seguente mostra come implementare un layout orizzontale a livello di codice. In questo caso, il layout ordina i riquadri per base `SpeakerSequence` e li colloca al di sotto della condivisione dello schermo. Il layout consente un massimo di quattro riquadri e applica un rapporto di aspetto 16/9.
```
{
"CompositedVideo":{
"Layout":"GridView",
"Resolution":"FHD",
"GridViewConfiguration":{
"ContentShareLayout":"Horizontal",
"HorizontalLayoutConfiguration":{
"TileOrder":"SpeakerSequence",
"TilePosition":"Bottom",
"TileCount":4,
"TileAspectRatio":"16/9"
}
}
}
}
```
**HorizontalLayoutConfiguration**
*Descrizione*: le impostazioni di configurazione per un layout orizzontale
*Tipo*: HorizontalLayoutConfiguration oggetto
*Obbligatorio*: no
**HorizontalLayoutConfiguration.TilePosition**
*Descrizione*: posiziona i riquadri sopra o sotto una condivisione di contenuti.
*Tipo*: stringa
*Valori validi* — `Bottom` \$1 `Top`
*Obbligatorio*: no
*Predefinito*: parte inferiore
**HorizontalLayoutConfiguration.TileOrder**
*Descrizione*: ordina i riquadri in base al momento in cui gli utenti si uniscono o quando parlano
*Tipo*: stringa
*Valori validi* — `JoinSequence` \$1 `SpeakerSequence`
*Obbligatorio*: no
*Impostazione predefinita*: JoinSequence
**HorizontalLayoutConfiguration.TileCount**
*Descrizione*: specifica il numero di riquadri che rimangono visibili durante una condivisione dello schermo
*Tipo*: numero intero
*Valori validi: 1—10*
*Obbligatorio*: no
*Impostazione predefinita*: 4
**HorizontalLayoutConfiguration.TileAspectRatio**
*Descrizione*: specifica le proporzioni delle tessere
*Tipo*: numero intero
*Valori validi* ***: *n/n****
*Obbligatorio*: no
*Impostazione predefinita*: 16/9, il valore si applica a tutti i riquadri
## VerticalLayoutConfiguration
`VerticalLayoutConfiguration`visualizza la condivisione di contenuti e i quattro video più recenti raggruppati sulla destra. I relatori appaiono sempre in primo piano. Gli altri partecipanti vengono visualizzati nell'ordine stabilito da. `TileOrder`
![\[Immagine che mostra un grande riquadro video al centro di una finestra e 4 riquadri più piccoli impilati a destra.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/grid-vertical.png)
L'esempio seguente mostra come implementare il layout verticale a livello di codice. In questo caso, il layout ordina i riquadri per base JoinSequence e li colloca a destra della condivisione dello schermo. Il layout consente un massimo di quattro riquadri e applica un rapporto di aspetto 16/9.
```
{
"CompositedVideo":{
"Layout": "GridView",
"Resolution": "FHD",
"GridViewConfiguration":{
"ContentShareLayout": "Vertical",
"VerticalLayoutConfiguration":{
"TileOrder": "JoinSequence",
"TilePosition": "Right",
"TileCount": 4,
"TileAspectRatio": "16/9"
}
}
}
}
```
**VerticalLayoutConfiguration**
*Descrizione*: le impostazioni di configurazione per un layout verticale
*Tipo*: VerticalLayoutConfiguration oggetto
*Obbligatorio*: no
**VerticalLayoutConfiguration.TilePosition**
*Descrizione*: posiziona i riquadri a destra o a sinistra di una condivisione di contenuti.
*Tipo*: stringa
*Valori validi* — `Bottom` \$1 `Top`
*Obbligatorio*: no
*Predefinito*: parte inferiore
**VerticalLayoutConfiguration.TileOrder**
*Descrizione*: ordina i riquadri in base al momento in cui gli utenti si uniscono o quando parlano
*Tipo*: stringa
*Valori validi* — `JoinSequence` \$1 `SpeakerSequence`
*Obbligatorio*: no
*Impostazione predefinita*: JoinSequence
**VerticalLayoutConfiguration.TileCount**
*Descrizione*: specifica il numero di tessere
*Tipo*: numero intero
*Valori validi: 1—10*
*Obbligatorio*: no
*Impostazione predefinita*: 4
**VerticalLayoutConfiguration.TileAspectRatio**
*Descrizione*: specifica le proporzioni delle tessere
*Tipo*: numero intero
*Valori validi* ***: *n/n****
*Obbligatorio*: no
*Impostazione predefinita*: 9/16, il valore si applica a tutti i riquadri
# Creazione di un ruolo collegato ai servizi per le pipeline multimediali di Amazon Chime SDK
Le informazioni contenute nelle seguenti sezioni spiegano come creare un ruolo collegato ai servizi che consenta alle pipeline multimediali di accedere alle riunioni dell'SDK Amazon Chime.
**Topics**
+ [Impostazione delle autorizzazioni per i ruoli](#pipeline-role-permissions)
+ [Creazione del ruolo collegato ai servizi](#create-sl-role)
+ [Modifica del ruolo collegato ai servizi](#edit-pipeline-role)
+ [Eliminazione del ruolo collegato ai servizi](#delete-pipeline-role)
+ [Regioni che supportano ruoli collegati ai servizi](#role-supported-regions)
## Impostazione delle autorizzazioni per i ruoli
*le pipeline multimediali utilizzano un ruolo collegato al servizio denominato Pipelines. AWSService RoleForAmazonChime SDKMedia* Il ruolo consente alle pipeline di acquisizione di accedere alle riunioni dell'SDK Amazon Chime e di pubblicare i parametri su Amazon CloudWatch per tuo conto. Il ruolo si affida al servizio. `mediapipelines.chime.amazonaws.com`
La politica di autorizzazione dei ruoli consente all'SDK Amazon Chime di completare le seguenti azioni su tutte le risorse: AWS
+ Operazione: `cloudwatch:PutMetricData` su `all AWS resources`
+ Operazione: `chime:CreateAttendee` su `all AWS resources`
+ Operazione: `chime:DeleteAttendee` su `all AWS resources`
+ Operazione: `chime:GetMeeting` su `all AWS resources`
+ Operazione: `kinesisvideo:CreateStream` su `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Operazione: `kinesisvideo:PutMedia` su `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Operazione: `kinesisvideo:UpdateDataRetention` su `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Operazione: `kinesisvideo:DescribeStream` su `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Operazione: `kinesisvideo:GetDataEndpoint` su `arn:aws:kinesisvideo:*:111122223333:stream/ChimeMediaPipelines-*`
+ Operazione: `kinesisvideo:ListStreams` su `arn:aws:kinesisvideo:*:111122223333:stream/*`
È necessario configurare le autorizzazioni per consentire a un'entità IAM, ad esempio un utente, un gruppo o un ruolo, di creare, modificare o eliminare un ruolo collegato ai servizi. *Per ulteriori informazioni sulle autorizzazioni, consulta [Service Linked Role permissions](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) nella IAM User Guide.*
## Creazione del ruolo collegato ai servizi
Utilizza la console IAM per creare un ruolo collegato ai servizi da utilizzare con le pipeline multimediali di Amazon Chime SDK. È necessario disporre delle autorizzazioni amministrative IAM per completare questi passaggi. In caso contrario, contatta un amministratore di sistema.
**Come creare il ruolo**
1. Accedi alla console di AWS gestione, quindi apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam).
1. Nel pannello di navigazione della console IAM, scegliere **Ruoli** e quindi **Crea ruolo**.
1. Scegli il tipo di ruolo **AWS Service**, quindi scegli **Chime SDK Media Pipelines**.
Viene visualizzata la policy IAM.
1. Seleziona la casella di controllo accanto alla politica, quindi scegli **Avanti: Tag**.
1. Scegli **Prossimo: Rivedi**.
1. Modifica la descrizione in base alle esigenze, quindi scegli **Crea ruolo**.
*Puoi anche utilizzare la AWS CLI o l' AWS API per creare un ruolo collegato al servizio denominato mediapipelines.chime.amazonaws.com.* Nella AWS CLI, esegui questo comando:
```
aws iam create-service-linked-role --aws-service-name mediapipelines.chime.amazonaws.com
```
Per ulteriori informazioni sulla creazione del ruolo, consulta [Creating a Service-Linked Role](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) nella *IAM* User Guide. Se elimini questo ruolo, puoi utilizzare lo stesso processo per crearlo di nuovo.
## Modifica del ruolo collegato ai servizi
Non puoi modificare il ruolo collegato al servizio *AWSServiceRoleForAmazonChimeSDKMediaPipelines*. Dopo aver creato il ruolo, non puoi cambiarne il nome perché altre entità potrebbero fare riferimento al ruolo. Tuttavia, puoi utilizzare IAM per modificare la descrizione del ruolo. Per ulteriori informazioni, consulta [Modifica di un ruolo collegato ai servizi](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) nella *Guida per l'utente di IAM*.
## Eliminazione del ruolo collegato ai servizi
Se non hai bisogno di un ruolo collegato al servizio, ti consigliamo di eliminarlo. Per fare ciò, devi prima eliminare le pipeline multimediali che utilizzano il ruolo. Puoi utilizzare la AWS CLI o l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API per eliminare le pipeline.
**Utilizzo della CLI per eliminare le pipeline**
Usa questo comando nella AWS CLI per eliminare le pipeline multimediali nel tuo account.
```
aws chime-sdk-media-pipelines delete-media-capture-pipeline --media-pipeline-id Pipeline_Id
```
**Utilizzo di un'API per eliminare le pipeline**
Usa l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API per eliminare le pipeline multimediali nel tuo account.
**Eliminazione del ruolo**
Dopo aver eliminato le pipeline, puoi utilizzare la console IAM, la AWS CLI o AWS l'API per eliminare il ruolo. *Per ulteriori informazioni sull'eliminazione dei ruoli, consulta [Eliminazione di un ruolo collegato ai servizi nella Guida per l'utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role).*
## Regioni che supportano ruoli collegati ai servizi
Amazon Chime SDK supporta l'utilizzo di ruoli collegati al servizio in tutte le AWS regioni in cui il servizio è disponibile. Per ulteriori informazioni, consulta gli [endpoint e le quote dell'SDK Amazon Chime](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) nel. *Riferimenti generali di Amazon Web Services*
# Utilizzo degli eventi della pipeline multimediale di Amazon Chime SDK
Ogni tipo di pipeline multimediale invia eventi del ciclo di vita, che puoi utilizzare per attivare notifiche e avviare flussi di lavoro a valle. Alcuni esempi di utilizzo degli eventi della pipeline multimediale includono:
+ Elaborazione dei file multimediali acquisiti dopo il completamento di una pipeline multimediale.
+ Notifica ai partecipanti alla riunione se una pipeline multimediale presenta un errore temporaneo.
+ Interruzione di una riunione in caso di guasto permanente di una pipeline multimediale.
Puoi inviare eventi ad Amazon EventBridge, Amazon Simple Notification Service (SNS) e Amazon Simple Queue Service (SQS). Per ulteriori informazioni, consulta [Events from AWS services](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) nella *Amazon EventBridge User Guide*.
## Creata la pipeline multimediale di Amazon Chime SDK
L'SDK Amazon Chime invia questo evento quando viene creata la pipeline multimediale.
**Esempio: dati relativi agli eventi**
Di seguito vengono riportati dati di esempio per questo evento.
```
{
"version": "0",
"id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "111122223333",
"time": "2021-07-28T20:20:49Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "0",
"eventType": "chime:MediaPipelineInProgress",
"timestamp": 1627503649251,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1"
}
}
```
## Pipeline multimediale Amazon Chime SDK eliminata
L'SDK Amazon Chime invia questo evento dopo che la pipeline multimediale si è interrotta correttamente.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo evento.
```
{
"version": "0",
"id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "365135496707",
"time": "2021-07-28T20:21:50Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "0",
"eventType": "chime:MediaPipelineDeleted",
"timestamp": 1627503710485,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1"
}
}
```
## La pipeline multimediale di Amazon Chime SDK presenta un errore temporaneo
L'SDK Amazon Chime invia questo evento quando la pipeline multimediale presenta un errore temporaneo.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo evento.
```
{
"version": "0",
"id": "abc141e1-fc2e-65e8-5f18-ab5130f1035a",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "365135496707",
"time": "2021-07-28T21:16:42Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "0",
"eventType": "chime:MediaPipelineTemporaryFailure",
"timestamp": 1627507002882,
"meetingId": "7a5434e3-724a-4bbb-9eb6-2fb209dc0706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "ebd62f4e-04a9-426d-bcb0-974c0f266400",
"mediaRegion": "eu-south-1"
}
}
```
## Pipeline multimediale Amazon Chime SDK in corso
L'SDK Amazon Chime invia questo evento quando la pipeline multimediale inizia a catturare artefatti.
**Esempio: dati sugli eventi**
Di seguito vengono riportati dati di esempio per questo evento.
```
{
"version": "0",
"id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "365135496707",
"time": "2021-07-28T20:21:50Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "0",
"eventType": "chime:MediaPipelineInProgress",
"timestamp": 1627503710485?,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1"
}
}
```
## Errore permanente della pipeline multimediale dell'SDK Amazon Chime
L'SDK Amazon Chime invia questo evento quando una pipeline multimediale si guasta permanentemente.
**Esempio: dati relativi agli eventi**
Di seguito vengono riportati dati di esempio per questo evento.
```
{
"version": "0",
"id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
"detail-type": "Chime Media Pipeline State Change",
"source": "aws.chime",
"account": "365135496707",
"time": "2021-07-28T20:21:50Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "0",
"eventType": "chime:MediaPipelinePermanentFailure",
"timestamp": 1627503710485,
"meetingId": "1e6bf4f5-f4b5-4917-b8c9-bda45c340706",
"externalMeetingId": "Meeting_Id",
"mediaPipelineId": "e40ee45e-2ed1-408e-9156-f52b8208a491",
"mediaRegion": "ap-southeast-1"
}
}
```
# Impostazione delle autorizzazioni del bucket Amazon S3 per le pipeline multimediali di Amazon Chime SDK
Se non hai creato un bucket Amazon S3, assicurati di crearlo nell'account e nella regione in cui organizzi le riunioni. Inoltre, assicurati di concedere le autorizzazioni adeguate al servizio. Per ulteriori informazioni sulla creazione di un bucket Amazon S3, consulta. [Creazione di un bucket Amazon S3 per le pipeline di acquisizione multimediale di Amazon Chime SDK](create-s3-bucket.md)
# Invio di eventi della pipeline multimediale di Amazon Chime SDK a CloudTrail
AWS abilita CloudTrail per te quando crei il tuo account. AWS Quando un utente chiama un'API supportata nell'SDK di Media Pipeline, CloudTrail registra l'attività per quell'API nella **cronologia degli eventi**, insieme ad altri eventi. AWS Puoi visualizzare, cercare e scaricare gli eventi della pipeline multimediale nel tuo account AWS. Per ulteriori informazioni, consulta [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) nella *Guida per l'CloudTrail utente*.
Per una registrazione continua degli eventi della pipeline multimediale, puoi creare un *percorso*. Un trail consente di CloudTrail inviare file di log al tuo bucket Amazon S3. L'esempio seguente mostra un percorso della pipeline multimediale. I dati includono l'utente che ha chiamato l'API, il ruolo IAM utilizzato per chiamare l'API e i timestamp. Per ulteriori informazioni sull'utilizzo, CloudTrail consulta [Logging and monitoring](https://docs.aws.amazon.com/chime-sdk/latest/ag/monitoring-overview.html) nella *Amazon Chime SDK Administrator* Guide.
```
{
"Records": [
{
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "ABCDEFGHIJKLMNOPQRSTUV:user-name",
"arn": "arn:aws:sts::123456789101:assumed-role/role-name/user-name",
"accountId": "109876543210",
"accessKeyId": "ABCDEFGHIJKLMNOPQRSTUV",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "ABCDEFGHIJKLMNOPQRSTUV",
"arn": "arn:aws:iam::109876543210:role/role-name",
"accountId": "012345678910",
"userName": "user-name"
},
"webIdFederationData": {},
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2022-03-08T19:34:55Z"
}
}
},
"eventTime": "2022-03-08T20:28:41Z",
"eventSource": "chime-sdk-media-pipelines.amazonaws.com",
"eventName": "CreateMediaCapturePipeline",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "[]/[]",
"requestParameters": {
"sourceType": "ChimeSdkMeeting",
"sourceArn": "Hidden_For_Security_Reasons",
"sinkType": "S3Bucket",
"sinkArn": "Hidden_For_Security_Reasons",
"chimeSdkMeetingConfiguration": {
"artifactsConfiguration": {
"audio": {
"muxType": "AudioOnly"
},
"video": {
"state": "Enabled",
"muxType": "VideoOnly"
},
"content": {
"state": "Enabled",
"muxType": "ContentOnly"
}
}
}
},
"responseElements": {
"mediaCapturePipeline": {
"mediaPipelineId": "pipeline-uuid",
"sourceType": "ChimeSdkMeeting",
"sourceArn": "Hidden_For_Security_Reasons",
"status": "Initializing",
"sinkType": "S3Bucket",
"sinkArn": "Hidden_For_Security_Reasons",
"createdTimestamp": "2022-03-08T20:28:41.336Z",
"updatedTimestamp": "2022-03-08T20:28:41.463Z",
"chimeSdkMeetingConfiguration": {
"artifactsConfiguration": {
"audio": {
"muxType": "AudioOnly"
},
"video": {
"state": "Enabled",
"muxType": "VideoOnly"
},
"content": {
"state": "Enabled",
"muxType": "ContentOnly"
}
}
}
}
},
"requestID": "request-id",
"eventID": "event-id",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"eventCategory": "Management",
"recipientAccountId": "112233445566",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"clientProvidedHostHeader": "example.com"
}
},
]
}
```
# Le migliori pratiche per interrompere le pipeline multimediali di Amazon Chime SDK
Come procedura consigliata per interrompere le pipeline multimediali, chiamate l'API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) L'API consente di eliminare le pipeline Media Capture e Media Live Connector. Puoi anche chiamare l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaCapturePipeline.html)API per eliminare le pipeline di acquisizione multimediale. Tutte le pipeline multimediali si interrompono al termine della riunione.