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à.
# Configurare lo streaming multimediale live dell’audio del cliente in Amazon Connect
In Amazon Connect puoi acquisire l'audio del cliente durante un'interazione con il contact center inviando l'audio a un flusso video Kinesis. A seconda delle impostazioni, l'audio può essere acquisito per l'interazione completa, fino al termine dell'interazione con l'agente, o solo in una direzione:
+ Ciò che il cliente sente, incluso ciò che dice l'agente e i prompt del sistema.
+ Cosa dice il cliente, anche quando è in attesa.
I flussi audio dei clienti includono anche le interazioni con un bot Amazon Lex, se ne usi uno all'interno del flusso.
**Topics**
+ [Pianificare lo streaming multimediale in tempo reale](plan-live-media-streams.md)
+ [Abilitare lo streaming multimediale in tempo reale](enable-live-media-streams.md)
+ [Accesso ai dati di Flusso di video Kinesis](access-media-stream-data.md)
+ [Testare lo streaming multimediale in tempo reale](use-media-streams-blocks.md)
+ [Attributi di contatto per lo streaming multimediale in tempo reale](media-streaming-attributes.md)
# Pianificare lo streaming multimediale live da Amazon Connect a Kinesis Video Streams
**Importante**
Se vuoi usare la funzionalità di streaming audio, devi mantenere i flussi creati da Amazon Connect. Non eliminarli, a meno che tu non voglia smettere di usare la funzione di streaming.
Puoi inviare tutto l'audio da e verso il cliente a Flusso di video Kinesis. Lo streaming multimediale utilizza il supporto multi-traccia di Kinesis Video Streams per fare in modo che ciò che il cliente dice si trovi su una traccia separata rispetto a ciò che il cliente sente.
L'audio inviato a Kinesis usa una frequenza di campionamento di 8 kHz.
## Hai bisogno di aumentare le quote di servizio?
Quando abiliti lo streaming multimediale in Amazon Connect, viene usato un flusso video Kinesis per ogni chiamata attiva. Creiamo nuovi flussi KVS in base alle esigenze per gestire le richieste di streaming simultanee. Creiamo automaticamente flussi aggiuntivi in base alle esigenze per tenere il passo con le chiamate attive, a meno che il tuo account non raggiunga la [quota del servizio Flusso di video Kinesis](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html).
Contattaci Supporto per richiedere un aumento **del numero di stream**.
Per richiedere un aumento della quota di servizio, nel AWS Support Center, scegli **Crea caso**, quindi scegli **Aumento della quota di servizio**.
**Suggerimento**
Ci assicuriamo che **PutMedia**le richieste rimangano sempre entro la quota di 5 TPS. Non è necessario richiedere un aumento.
## Per quanto tempo deve essere memorizzato l'audio?
L'audio del cliente viene archiviato in Kinesis per il tempo definito dalle impostazioni di conservazione in un'istanza Amazon Connect. Per istruzioni sull'impostazione di questo valore, consulta [Abilitare lo streaming multimediale live nell’istanza Amazon Connect](enable-live-media-streams.md).
## Hai bisogno di cambiare i flussi audio?
Ti consigliamo di evitare di modificare i flussi. La modifica può causare un comportamento imprevisto.
## Chi richiede le autorizzazioni IAM per recuperare i dati?
Se la tua azienda utilizza le autorizzazioni IAM, l' AWS amministratore dovrà concedere le autorizzazioni ai ruoli IAM che devono recuperare i dati da Kinesis Video Streams. Dovrà concedere autorizzazioni di accesso completo per Kinesis Video Streams e AWS Key Management Service.
# Abilitare lo streaming multimediale live nell’istanza Amazon Connect
Lo streaming multimediale in tempo reale (flussi audio dei clienti) non è abilitato per impostazione predefinita. Puoi abilitare i flussi audio dei clienti dalla pagina delle impostazioni per la tua istanza.
**Per abilitare lo streaming di contenuti multimediali in tempo reale**
1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.
1. Nel riquadro di navigazione, selezionare **Data storage (Storage dei dati)**.
1. Scegliere **Edit (Modifica)** in **Live media streaming (Streaming di contenuti multimediali in tempo reale)**. Scegliere **Enable live media streaming (Abilita streaming multimediale in tempo reale)**.
1. Immetti un prefisso per le istanze Flussi di video Kinesis create per l'audio del cliente. Questo prefisso rende più semplice identificare il flusso di dati.
1. I dati vengono crittografati prima della scrittura nel livello di archiviazione di Kinesis Video Streams e vengono decrittografati dopo essere stati recuperati dall’archiviazione. Di conseguenza, i dati vengono sempre crittografati a riposo all’interno del servizio Kinesis Video Streams. Scegli la chiave KMS utilizzata per crittografare i dati all’interno di Kinesis Video Streams, come mostrato nell’immagine seguente.
![\[La sezione Crittografia in cui scegli la chiave KMS.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/streaming-encryption.png)
Quando scegli di inserire la tua chiave, tieni presente le seguenti restrizioni:
1. La chiave deve trovarsi nella stessa regione dell'istanza.
1. La chiave KMS deve essere:
+ Una chiave gestita dal cliente
O
+ La chiave AWS gestita per Kinesis Video Streams (aws/kinesisvideo).
Non dovrebbe essere nessuna delle chiavi AWS gestite create automaticamente per altri servizi (ad esempio,). aws/connect, aws/lambda, aws/kinesis
1. La concessione fornita per la chiave da Amazon Connect non deve essere revocata. Queste concessioni avrebbero `GranteePrincipal` nel formato:
```
arn:aws:iam::customer-account-id:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hash_suffix
```
1. Specificare un numero e un'unità per il **Data retention period (Periodo di conservazione dei dati)**.
**Importante**
Se selezioni **Nessun dato conservato**, i dati non vengono conservati e possono essere usati per soli 5 minuti. Questo è il periodo minimo predefinito per cui Kinesis conserva i dati.
Poiché Amazon Connect utilizza Kinesis per lo streaming, vengono applicate le [quote di Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).
1. Scegliere **Save (Salva)** in **Live media streaming (Streaming di contenuti multimediali in tempo reale)**, quindi scegliere **Save (Salva)** nella parte inferiore della pagina.
Dopo aver abilitato lo streaming di contenuti multimediali live, aggiungi i blocchi **Avvia streaming di contenuti multimediali** e **Interrompi streaming di contenuti multimediali** al flusso. Configura questi blocchi per specificare l'audio che vuoi acquisire. Per istruzioni e un esempio, consulta [Esempio di flusso per il test dello streaming multimediale live in Amazon Connect](use-media-streams-blocks.md).
# Sviluppare lo streaming multimediale live in Amazon Connect
Per aiutarti a iniziare a sviluppare utilizzando lo streaming multimediale live, Amazon Connect include il seguente repository Kinesis Video Streams che contiene un esempio di base di come utilizzare i dati audio dai tuoi Kinesis Video Streams: [https://github.com/amazon-connect/connect-kvs-consumer-demo](https://github.com/amazon-connect/connect-kvs-consumer-demo)
Questa demo si basa sulle astrazioni di alto livello fornite dalla libreria di parser di Kinesis Video Streams per leggere le tracce `AUDIO_TO_CUSTOMER` e `AUDIO_FROM_CUSTOMER` pubblicate da Amazon Connect. Questi dati vengono archiviati come file PCM non elaborato. Questo file può essere trasformato, transcodificato o riprodotto.
# Esempio di flusso per il test dello streaming multimediale live in Amazon Connect
Ecco come configurare un flusso per testare lo streaming di contenuti multimediali live:
1. Aggiungere un blocco **Avvia lo streaming multimediale** nel punto in cui si desidera abilitare lo streaming audio del cliente.
1. Collega il ramo **Success (Successo)** al resto del flusso.
1. Aggiungere un blocco **Arresta lo streaming multimediale** nel punto in cui si desidera arrestare lo streaming.
1. **Configura entrambi i blocchi per specificare cosa vuoi trasmettere in streaming: **dal** cliente al cliente. and/or **
![\[Blocco Avvia streaming di contenuti multimediali.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/start-media-streaming.png)
L'audio del cliente viene acquisito fino all'invocazione di un blocco **Arresta streaming di contenuti multimediali**, anche se il contatto è passato a un altro flusso.
Usa gli attributi di contatto per lo streaming di contenuti multimediali nel tuo flusso in modo da includerli nel record di contatto. Puoi quindi visualizzare il record di contatto per determinare i dati di streaming di contenuti multimediali associati a un contatto specifico. Puoi anche passare gli attributi a una AWS Lambda funzione.
Il flusso di esempio seguente mostra come usare lo streaming di contenuti multimediali con gli attributi per scopi di test. Questo flusso include il blocco **Avvia streaming di contenuti multimediali**, ma non il blocco **Interrompi streaming di contenuti multimediali**.
![\[Esempio di flusso con blocco Avvia streaming di contenuti multimediali.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/media-streaming-flow.png)
**Dopo che l'audio è stato trasmesso correttamente a Kinesis Video Streams, gli attributi dei contatti vengono compilati dal blocco di funzioni Invoke Lambda. AWS ** Puoi utilizzare gli attributi per identificare la posizione nel flusso in cui l'audio del cliente viene avviato. Per istruzioni, consulta [Attributi di contatto per lo streaming multimediale live in Kinesis Video Streams](media-streaming-attributes.md).
# Attributi di contatto per lo streaming multimediale live in Kinesis Video Streams
Gli attributi vengono visualizzati quando selezioni **Flussi contenuti multimediali** per **Tipo** in un blocco del flusso che supporta gli attributi, ad esempio il blocco **Avvia streaming di contenuti multimediali**. Queste includono i seguenti:
ARN del flusso audio del cliente
ARN del flusso video Kinesis che include i dati dei clienti a cui fare riferimento.
**JSONPath formato**: \$1. MediaStreams.customer.audio.Streamarn
Timestamp inizio audio del cliente
L'ora in cui viene avviato il flusso audio del cliente.
**JSONPath formato: \$1.** MediaStreams.Audio del cliente. StartTimestamp
Timestamp fine audio del cliente
L'ora in cui il flusso audio del cliente viene interrotto.
**JSONPath formato:** \$1. MediaStreams.Audio del cliente. StopTimestamp
Numero di frammento inizio audio del cliente
Il numero che identifica il frammento Kinesis Video Streams nel quale viene avviato il flusso audio del cliente.
**JSONPath formato:** \$1. MediaStreams.Audio del cliente. StartFragmentNumber
Per ulteriori informazioni sui frammenti di Flusso di video Amazon Kinesis, consulta [Fragment](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html) nella *Guida per gli sviluppatori di Flusso di video Amazon Kinesis*.