

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 sottotitoli video
<a name="subtitles"></a>

Amazon Transcribe supporta gli output WebVTT (\*.vtt) SubRip e (\*.srt) da utilizzare come sottotitoli video. È possibile selezionare uno o entrambi i tipi di file quando si imposta il processo di trascrizione video in batch. Quando si utilizza la funzionalità dei sottotitoli, vengono prodotti i file di sottotitoli selezionati e un normale file di trascrizione (contenente informazioni aggiuntive). I file di sottotitoli e trascrizioni vengono inviati alla stessa destinazione.

I sottotitoli vengono visualizzati contemporaneamente alla pronuncia del testo e rimangono visibili fino a quando non si verifica una pausa naturale o finché il parlante non finisce di parlare. Tieni presente che se abiliti i sottotitoli nella richiesta di trascrizione e l'audio non contiene alcun dialogo, non viene creato un file di sottotitoli.

**Importante**  
Amazon Transcribe utilizza un indice iniziale predefinito di `0` per l'output dei sottotitoli, che differisce dal valore più utilizzato di. `1` Se hai bisogno di un indice iniziale di`1`, puoi specificarlo nella Console di gestione AWS o nella tua richiesta API utilizzando il [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html#transcribe-Type-Subtitles-OutputStartIndex](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html#transcribe-Type-Subtitles-OutputStartIndex)parametro.

L'utilizzo di un indice iniziale errato può causare errori di compatibilità con altri servizi, quindi assicurati di verificare l'indice iniziale richiesto prima di creare i sottotitoli. Se non hai certezza del valore da utilizzare, ti consigliamo di scegliere `1`. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

Funzionalità supportate con i sottotitoli:
+ **Redazione dei contenuti**: qualsiasi contenuto redatto viene visualizzato come “`PII`” sia nei sottotitoli che nei normali file di output delle trascrizioni. L'audio non viene alterato.
+ **Filtri del vocabolario**: i file dei sottotitoli vengono generati dal file di trascrizione, quindi tutte le parole filtrate nell'output di trascrizione standard vengono filtrate anche nei sottotitoli. I contenuti filtrati vengono visualizzati come spazi bianchi o `***` nei file di trascrizione e sottotitoli. L'audio non viene alterato.
+ **Diarizzazione dei parlanti**: se in un determinato segmento di sottotitoli sono presenti più parlanti, vengono utilizzati dei trattini per distinguere ciascun parlante. Questo vale sia per WebVTT che per i formati, ad SubRip esempio:
  + -- Testo pronunciato dalla persona 1
  + -- Testo pronunciato dalla persona 2

I file dei sottotitoli vengono memorizzati nella stessa Amazon S3 posizione dell'output della trascrizione.

Per una video guida sulla creazione dei sottotitoli, consulta:

[![AWS Videos](http://img.youtube.com/vi/PZdfXGggcH4/0.jpg)](http://www.youtube.com/watch?v=PZdfXGggcH4)


## Generazione di file di sottotitoli
<a name="subtitles-how-to"></a>

Puoi creare file di sottotitoli utilizzando la **Console di gestione AWS**, l'**AWS CLI** o gli **SDK AWS **; consulta i seguenti esempi:

### Console di gestione AWS
<a name="subtitles-console"></a>

1. Accedi alla [Console di gestione AWS](https://console.aws.amazon.com/transcribe/).

1. Nel riquadro di navigazione, scegli **Processi di trascrizione**, quindi seleziona **Crea processo** (in alto a destra). Si aprirà la pagina **Specifica i dettagli del processo**. Le opzioni per i sottotitoli si trovano nel pannello **Dati di output**.

1. Seleziona i formati che desideri per i file dei sottotitoli, quindi scegli un valore per l'indice iniziale. Nota che l' Amazon Transcribe impostazione predefinita è`0`, ma `1` è più utilizzata. Se non hai certezza del valore da utilizzare, ti consigliamo di scegliere `1`, in quanto ciò potrebbe migliorare la compatibilità con altri servizi.  
![Amazon Transcribe schermata della console: il riquadro «dati di output» nella pagina «specifica i dettagli del lavoro».](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/subtitles-startindex.png)

1. Compila tutti i campi che desideri includere nella pagina **Specifica i dettagli del processo**, quindi seleziona **Avanti**. Verrà visualizzata la **pagina Configura processo - *opzionale***.

1. Seleziona **Crea processo** per eseguire il processo di trascrizione. 

### AWS CLI
<a name="subtitles-cli"></a>

Questo esempio utilizza il comando [inizia-processo-trascrizione](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e il parametro `Subtitles`. Per ulteriori informazioni, consultare [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--transcription-job-name {{my-first-transcription-job}} \
--media MediaFileUri=s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}} \
--output-bucket-name {{amzn-s3-demo-bucket}} \
--output-key {{my-output-files}}/ \
--language-code {{en-US}} \
--subtitles Formats={{vtt}},{{srt}},OutputStartIndex={{1}}
```

Ecco un altro esempio che utilizza il comando [avvia processo trascrizione](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e un corpo della richiesta che aggiunge i sottotitoli al processo.

```
aws transcribe start-transcription-job \
--region {{us-west-2}} \
--cli-input-json file://{{my-first-subtitle-job}}.json
```

Il file *my-first-subtitle-job.json* contiene il seguente corpo della richiesta.

```
{
  "TranscriptionJobName": "{{my-first-transcription-job}}",
  "Media": {
        "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
  },
  "OutputBucketName": "{{amzn-s3-demo-bucket}}",
  "OutputKey": "{{my-output-files}}/", 
  "LanguageCode": "{{en-US}}",
  "Subtitles": {
        "Formats": [
            "{{vtt}}","{{srt}}"
        ],             
        "OutputStartIndex": {{1}}
   }
}
```

### AWS SDK per Python (Boto3)
<a name="subtitles-python-batch"></a>

[Questo esempio utilizza AWS SDK per Python (Boto3) per aggiungere i sottotitoli utilizzando l'argomento per il metodo start\_transcription\_job`Subtitles`.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Per ulteriori informazioni, consultare [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

Per ulteriori esempi di utilizzo degli AWS SDK, inclusi esempi relativi a funzionalità specifiche, scenari e interservizi, consulta il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDK](service_code_examples.md)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
job_name = "{{my-first-transcription-job}}"
job_uri = "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = '{{amzn-s3-demo-bucket}}',
    OutputKey = '{{my-output-files}}/', 
    LanguageCode = '{{en-US}}', 
    Subtitles = {
        'Formats': [
            '{{vtt}}','{{srt}}'
        ],
        'OutputStartIndex': {{1}} 
   }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```