Media Translation converte un file audio o un flusso di voce in testo di un altro lingua. Questa pagina fornisce esempi di codice che dimostrano come tradurre l'audio in streaming in testo utilizzando le librerie client di Media Translation.
Configura il progetto
Prima di poter utilizzare Media Translation, devi configurare un progetto Google Cloud e abilitare l'API Media Translation per il progetto.
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Enable the Media Translation API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Set the environment variable
GOOGLE_APPLICATION_CREDENTIALS
to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again. - Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Enable the Media Translation API.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Set the environment variable
GOOGLE_APPLICATION_CREDENTIALS
to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again. - Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Installa libreria client per la lingua che preferisci.
Traduci voce
Gli esempi di codice di seguito mostrano come tradurre il parlato da un file contenente fino a 5 minuti di audio o da un microfono in diretta. Consulta le best practice per consigli su come fornire dati vocali per la massima precisione in e riconoscimento degli oggetti.
I passaggi principali sono gli stessi indipendentemente dalla sorgente audio:
Inizializza un client
SpeechTranslationServiceClient
da utilizzare per l'invio richieste a Media Translation.Puoi riutilizzare lo stesso client per più richieste.
Crea una
StreamingTranslateSpeechConfig
request che specifica come elaborare l'audio.L'oggetto
StreamingTranslateSpeechConfig
è composto da un oggettoTranslateSpeechConfig
fornisce informazioni sul file sorgente audio e unsingle_utterance
che specifica se Media Translation continua a tradurre anche quando l'oratore è in pausa.L'oggetto
TranslateSpeechConfig
fornisce dati tecnici specifiche per la sorgente audio (come codifica e frequenza di campionamento), imposta le lingue di origine e di destinazione per la traduzione (utilizzando il relativo BCP-47 codici lingua) e definisce il modello di traduzione utilizzato da Media Translation per la trascrizione.Invia una sequenza di
StreamingTranslateSpeechRequest
di richiesta di oggetti.Invii una sequenza di richieste per ogni file audio che vuoi tradurre. La prima richiesta fornisce l'elemento
StreamingTranslateSpeechConfig
oggetto della richiesta e le seguenti richieste forniscono i contenuti audio in modalità flusso.Ricevi il
StreamingTranslateSpeechResult
.Mentre qualsiasi risposta con un valore
text_translation_result.is_final
pari afalse
viene ricevuto, l'ultimo risultato tradotto sovrascrive quello precedente.Quando Media Translation ha un risultato finale,
text_translation_result.is_final
è impostato sutrue
e qualsiasi risultato di traduzione ricevuto successivamente viene aggiunto al risultato precedente. (In questo caso, il risultato precedente è non viene sovrascritta). Puoi restituire la traduzione completata e iniziare con una nuova sezione per la parte successiva della trascrizione e l'audio corrispondente.Quando lo speaker si arresta, se
single_utterance
è impostato su true nel campoStreamingTranslateSpeechConfig
, Media Translation restituirà un eventoEND_OF_SINGLE_UTTERANCE
perspeech_event_type
nella risposta. Il cliente interrompe l'invio di richieste, ma continuerà a ricevere risposte finché la traduzione è terminata.Lo streaming ha un limite di 5 minuti. Se superi questo limite, viene restituito Errore OUT_OF_RANGE.
Esempi di codice
Traduzione vocale da un file audio
Java
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Java documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Node.js documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Python documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Traduzione vocale da un microfono
Java
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Java documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Node.js documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Media Translation, vedi Librerie client di Media Translation. Per ulteriori informazioni, consulta API Media Translation Python documentazione di riferimento.
Per autenticarti a Media Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.