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à.
# File audio lunghi
Per creare file TTS per passaggi di testo lunghi, utilizza la funzionalità di *sintesi asincrona* di Amazon Polly. Questo utilizza i tre `SpeechSynthesisTask` APIs:
+ `StartSpeechSynthesisTask`: avvia una nuova attività di sintesi.
+ `GetSpeechSynthesisTask`: restituisce dettagli su un'attività di sintesi inviata in precedenza.
+ `ListSpeechSynthesisTasks`: elenca tutte le attività di sintesi inviate.
L'operazione `SynthesizeSpeech` produce audio quasi in tempo reale, con latenza relativamente ridotta nella maggior parte dei casi. A questo scopo, l'operazione può sintetizzare solo 3000 caratteri.
La funzionalità di sintesi asincrona di Amazon Polly consente di risolvere il problema dell'elaborazione di un documento di testo di dimensioni maggiori, modificando il modo in cui il documento viene sintetizzato e restituito. Quando una richiesta di sintesi viene effettuata inviando testo di input mediante `StartSpeechSynthesisTask`, Amazon Polly mette in coda le richieste, quindi le elabora in modo asincrono in background non appena sono disponibili risorse del sistema. Amazon Polly carica quindi la conseguente sintesi vocale o i contrassegni vocali vengono trasmessi direttamente sul bucket Amazon Simple Storage Service (Amazon S3) (obbligatorio) e notifica la disponibilità del file completato tramite l'argomento SNS (opzionale).
In questo modo, tutte le funzionalità ad eccezione dell'elaborazione quasi in tempo reale sono disponibili per testi lunghi fino a 100.000 caratteri fatturabili (o 200.000 caratteri totali).
Per sintetizzare un documento utilizzando questo metodo, è necessario disporre di un bucket Amazon S3 scrivibile su cui è possibile salvare il file audio. Puoi ricevere una notifica quando l'audio sintetizzato è pronto, specificando un identificatore Argomento SNS opzionale. Quando l'attività di sintesi viene completata, Amazon Polly pubblicherà un messaggio su tale argomento. Questo messaggio può contenere inoltre utili informazioni sugli errori nel caso in cui l'attività di sintesi non abbia avuto esito positivo. Per eseguire questa operazione, accertati che l'utente che crea l'attività di sintesi possa anche pubblicare sull'argomento SNS. Consulta la [documentazione di Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) per ulteriori informazioni su come creare e sottoscrivere un argomento SNS.
**Encryption** (Crittografia)
Se lo desideri, puoi memorizzare il file di output in un modulo crittografato nel bucket S3. Per fare ciò, abilita la [crittografia del bucket Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) che utilizza una delle cifrature di blocco più complesse disponibili, lo standard di crittografia avanzata a 256 bit (AES-256).
**Topics**
+ [Configurazione della politica IAM per la sintesi asincrona](asynchronous-iam.md)
+ [Creazione di file audio lunghi](longer-console.md)
# Configurazione della politica IAM per la sintesi asincrona
Per utilizzare la funzionalità di sintesi asincrona, è necessario disporre di una policy IAM che consenta quanto segue:
+ utilizzo di nuove operazioni Amazon Polly
+ scrittura sul bucket S3 di output
+ pubblicazione sull'argomento SNS di stato [facoltativo]
La policy seguente concede solo le autorizzazioni necessarie per la sintesi asincrona e può essere collegata all'utente IAM.
# Creazione di file audio lunghi
Puoi utilizzare la console di Amazon Polly per creare sintesi vocali lunghe mediante sintesi asincrona con la stessa funzionalità utilizzabile con l'interfaccia a riga di comando di AWS CLI. Questa operazione viene eseguita utilizzando la scheda **Text-to-Speech (Sintesi vocale)** in modo molto analogo a qualsiasi altra sintesi.
------
#### [ Console ]
Anche l'altra funzionalità di sintesi asincrona è disponibile tramite la console. La scheda **S3 synthesis tasks (Attività di sintesi S3)** riflette la funzionalità `ListSpeechSynthesisTasks` visualizzando tutte le attività salvate nel bucket S3 e consentendo di filtrarle in base alle esigenze. Facendo clic su una specifica attività singola, ne vengono visualizzati i dettagli, in modo analogo alla funzionalità `GetSpeechSynthesisTask`.
**Per sintetizzare un testo di grandi dimensioni utilizzando la console Amazon Polly**
1. Accedi a Console di gestione AWS e apri la console Amazon Polly all'indirizzo. [https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)
1. Scegli la scheda **Text-to-Speech** (Sintesi vocale). Seleziona **Long Form** come motore, se appropriato.
1. Con **SSML** attivato o disattivato, digita o incolla il testo nella casella di input.
1. Scegli la lingua, la regione e la voce per il testo.
1. Scegli **Save in S3** (Salva in S3).
**Nota**
Entrambe le opzioni **Download** e **Ascolta** sono disattivate se la lunghezza del testo supera il limite di 3.000 caratteri per il funzionamento in tempo reale`SynthesizeSpeech`.
1. La console apre un modulo in modo che sia possibile scegliere dove archiviare il file di output.
1. Inserisci il nome del bucket Amazon S3 di destinazione.
1. Inserire facoltativamente la chiave di prefisso dell'output.
**Nota**
Il bucket S3 di output deve essere scrivibile.
1. Se si desidera ricevere una notifica quando l'attività di sintesi viene completata, specificare l'identificatore argomento SNS facoltativo.
**Nota**
L'SNS deve essere aperto per la pubblicazione da parte dell'utente della console corrente per utilizzare questa opzione. Per ulteriori informazioni, consulta [Amazon Simple Notification Service (SNS)](https://aws.amazon.com/sns/).
1. Scegli **Save in S3** (Salva in S3).
**Per recuperare informazioni sulle attività di sintesi vocale**
1. Nella console, scegliere la scheda **S3 Synthesis Tasks (Attività sintesi vocale)**.
1. Le attività vengono visualizzate in ordine di data. Per filtrare le attività, in base allo stato, scegli **All statuses** (Tutti gli stati) e quindi scegli lo stato da utilizzare.
1. Per visualizzare i dettagli di un'attività specifica, scegliere il **Task ID (ID attività)** collegato.
------
#### [ AWS CLI ]
La funzionalità di *sintesi asincrona* di Amazon Polly ne utilizza tre `SpeechSynthesisTask` APIs per lavorare con grandi quantità di testo:
+ `StartSpeechSynthesisTask`: avvia una nuova attività di sintesi.
+ `GetSpeechSynthesisTask`: restituisce dettagli su un'attività di sintesi inviata in precedenza.
+ `ListSpeechSynthesisTasks`: elenca tutte le attività di sintesi inviate.
**Sintesi di grandi porzioni di testo (`StartSpeechSynthesisTask`)**
Quando desideri creare un file audio di dimensioni superiori rispetto a quello che puoi creare con l'operazione `SynthesizeSpeech` in tempo reale, utilizza l'operazione `StartSpeechSynthesisTask`. Oltre agli argomenti necessari per l'operazione `SynthesizeSpeech`, `StartSpeechSynthesisTask` richiede anche il nome di un bucket Amazon S3. Sono inoltre disponibili altri due argomenti facoltativi: un prefisso della chiave per il file di output e l'ARN per un argomento SNS se desideri ricevere la notifica di stato sull'attività.
+ `OutputS3BucketName`: il nome del bucket Amazon S3; in cui la sintesi deve essere caricata. Questo bucket deve trovarsi nella stessa regione del servizio Amazon Polly. Inoltre, l'utente IAM utilizzato per effettuare la chiamata deve avere accesso al bucket. [Campo obbligatorio]
+ `OutputS3KeyPrefix`: prefisso della chiave per il file di output. Utilizza questo parametro se desideri salvare i file di sintesi vocale di output in una chiave simile a una directory personalizzata nel tuo bucket. [Facoltativo].
+ `SnsTopicArn`: L'argomento SNS ARN da utilizzare se si desidera ricevere notifiche sullo stato dell'attività. Questo argomento SNS deve trovarsi nella stessa regione del servizio Amazon Polly. Inoltre, l'utente IAM utilizzato per effettuare la chiamata deve avere accesso all'argomento. [Facoltativo].
Ad esempio, l'esempio seguente può essere utilizzato per eseguire il `start-speech-synthesis-task` AWS CLI comando nella regione Stati Uniti orientali (Ohio):
L' AWS CLI esempio seguente è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione Unix barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^) e usa virgolette (") attorno al testo di input con virgolette singole (') per i tag interni.
```
aws polly start-speech-synthesis-task \
--region us-east-2 \
--endpoint-url "https://polly.us-east-2.amazonaws.com/" \
--output-format mp3 \
--output-s3-bucket-name your-bucket-name \
--output-s3-key-prefix optional/prefix/path/file \
--voice-id Joanna \
--text file://text_file.txt
```
Questo determinerà una risposta simile a questa:
```
"SynthesisTask":
{
"OutputFormat": "mp3",
"OutputUri": "https://s3.us-east-2.amazonaws.com/your-bucket-name/optional/prefix/path/file..mp3",
"TextType": "text",
"CreationTime": [..],
"RequestCharacters": [..],
"TaskStatus": "scheduled",
"TaskId": [task_id],
"VoiceId": "Joanna"
}
```
L'operazione `start-speech-synthesis-task` restituisce diversi nuovi campi:
+ `OutputUri`: il percorso dei file di sintesi vocale di output.
+ `TaskId`: un identificatore unico per l'attività di sintesi vocale generata da Amazon Polly.
+ `CreationTime`: un timestamp che specifica quando l'attività è stata inviata inizialmente.
+ `RequestCharacters`: il numero di caratteri fatturabili nell'attività.
+ `TaskStatus`: fornisce informazioni sullo stato dell'attività inviata.
Quando la tua attività è stata inviata, lo stato iniziale mostrerà `scheduled`. Quando Amazon Polly avvia l'elaborazione dell'attività, lo stato passerà a `inProgress` e in seguito a `completed` o `failed`. Se l'operazione non riesce, verrà restituito un messaggio di errore quando si chiama l' GetSpeechSynthesisTask operazione or. ListSpeechSynthesisTasks
Una volta completata l'attività, il file di sintesi vocale è disponibile nel percorso specificato in `OutputUri`.
**Recupero di informazioni sull'attività di sintesi vocale**
Puoi ottenere informazioni su un'attività, ad esempio gli errori, lo stato e così via, utilizzando l'operazione `GetSpeechSynthesisTask`. Per eseguire questa operazione, è necessario il `task-id` restituito da `StartSpeechSynthesisTask`.
Ad esempio, è possibile utilizzare l'esempio seguente per eseguire il `get-speech-synthesis-task` AWS CLI comando:
```
aws polly get-speech-synthesis-task \
--region us-east-2 \
--endpoint-url "https:// polly.us-east-2.amazonaws.com/" \
--task-id task identifier
```
Puoi inoltre elencare tutte le attività di sintesi vocale che hai eseguito nella regione corrente utilizzando l'operazione `ListSpeechSynthesisTasks`.
Ad esempio, l'esempio seguente può essere utilizzato per eseguire il `list-speech-synthesis-tasks` AWS CLI comando:
```
aws polly list-speech-synthesis-tasks \
--region us-east-2 \
--endpoint-url "https:// polly.us-east-2.amazonaws.com/"
```
------