

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 (\$1.vtt) SubRip e (\$1.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/https://www.youtube.com/embed/PZdfXGggcH4/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/PZdfXGggcH4)


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

È possibile creare file di sottotitoli utilizzando **Console di gestione AWS**AWS CLI****, o **AWS SDKs**; consultate 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. Si noti 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 e il parametro. [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)`Subtitles` Per ulteriori informazioni, consulta [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 di utilizzo del [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e un corpo della richiesta che aggiunge i sottotitoli a quel lavoro.

```
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 il AWS SDK per Python (Boto3) per aggiungere i sottotitoli utilizzando l'`Subtitles`argomento per il metodo start\$1transcription\$1job.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Per ulteriori informazioni, consulta [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 di, inclusi esempi relativi a scenari AWS SDKs e servizi diversi, inclusi esempi relativi a funzionalità specifiche, consultate il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDKs](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)
```