Condividi tramite


SpeechTranslationConfig class

Configurazione della traduzione vocale.

Extends

Proprietà

authorizationToken

Ottiene/Imposta il token di autorizzazione. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido.

endpointId

Ottiene l'ID endpoint di un modello di riconoscimento vocale personalizzato usato per il riconoscimento vocale.

outputFormat

Ottiene il formato di output del riconoscimento vocale (semplice o dettagliato). Nota: questo formato di output è per il risultato del riconoscimento vocale, usare [SpeechConfig.speechSynthesisOutputFormat] per ottenere il formato di output audio sintetizzato.

region
speechRecognitionLanguage

Ottiene/Imposta la lingua di riconoscimento vocale.

speechSynthesisLanguage

Ottiene la lingua del sintetizzatore vocale. Aggiunta nella versione 1.11.0.

speechSynthesisOutputFormat

Ottiene il formato di output della sintesi vocale. Aggiunta nella versione 1.11.0.

speechSynthesisVoiceName

Ottiene la voce del sintetizzatore vocale. Aggiunta nella versione 1.11.0.

subscriptionKey
targetLanguages

Ottiene la lingua di destinazione (testo) da tradurre.

voiceName

Ottiene il nome voce selezionato.

Metodi

addTargetLanguage(string)

Aggiungere una lingua di destinazione (testo) da tradurre.

close()

Eliminare le risorse associate.

fromAuthorizationToken(string, string)

Istanza statica di SpeechTranslationConfig restituita passando il token di autorizzazione e l'area del servizio. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo impostando l'autorizzazione della proprietàToken con un nuovo token valido. In caso contrario, tutti i riconoscimento creati da questa istanza speechTranslationConfig riscontrano errori durante il riconoscimento. Man mano che i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscimento, il nuovo valore del token non verrà applicato ai riconoscimento già creati. Per i riconoscimento creati prima, è necessario impostare il token di autorizzazione del riconoscimento corrispondente per aggiornare il token. In caso contrario, i riconoscimento riscontrano errori durante il riconoscimento.

fromEndpoint(URL, string)

Crea un'istanza della configurazione della traduzione vocale con l'endpoint e la chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un endpoint di servizio non standard o paramters. Nota: le proprietà di query specificate nell'URL dell'endpoint non vengono modificate, anche se vengono impostate da qualsiasi altra API. Ad esempio, se il linguaggio è definito nell'URI come parametro di query "language=de-DE" e impostato anche dalla proprietà speechRecognitionLanguage, l'impostazione della lingua nell'uri ha la precedenza e il linguaggio effettivo è "de-DE". Solo le proprietà non specificate nell'URL dell'endpoint possono essere impostate da altre API. Nota: per usare il token di autorizzazione con fromEndpoint, passare una stringa vuota alla sottoscrizioneKey nel metodo fromEndpoint e quindi impostare authorizationToken="token" nell'istanza di SpeechConfig creata per usare il token di autorizzazione.

fromHost(URL, string)

Crea un'istanza della configurazione del riconoscimento vocale con la chiave host e sottoscrizione specificata. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Verrà assunto il percorso delle risorse standard. Per i servizi con un percorso di risorse non standard o nessun percorso, usare invece fromEndpoint. Nota: i parametri di query non sono consentiti nell'URI host e devono essere impostati da altre API. Nota: per usare un token di autorizzazione con fromHost, usare fromHost(URL) e quindi impostare la proprietà AuthorizationToken nell'istanza di SpeechConfig creata. Nota: aggiunto nella versione 1.9.0.

fromSubscription(string, string)

Istanza statica di SpeechTranslationConfig restituita passando una chiave di sottoscrizione e un'area del servizio.

setProperty(string | PropertyId, string)

Imposta una proprietà denominata come valore

Metodi ereditati

enableAudioLogging()

Abilitare la registrazione audio nel servizio. I log di audio e contenuto vengono archiviati nell'archiviazione di proprietà Microsoft o nell'account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (Bring Your Own Storage (BYOS) abilitata per la risorsa Voce. I log verranno rimossi dopo 30 giorni. Aggiunta nella versione 1.7.0.

enableDictation()

Abilitare la dettatura. Supportato solo nel riconoscimento vocale continuo. Aggiunta nella versione 1.7.0.

getProperty(string, string)

Restituisce il valore corrente di una proprietà arbitraria.

requestWordLevelTimestamps()

Include timestamp a livello di parola. Aggiunta nella versione 1.7.0.

setProfanity(ProfanityOption)

Imposta l'opzione volgarità. Aggiunta nella versione 1.7.0.

setProxy(string, number)

Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0.

setProxy(string, number, string, string)

Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0.

setServiceProperty(string, string, UriQueryParameter)

Imposta un valore di proprietà che verrà passato al servizio usando il canale specificato. Aggiunta nella versione 1.7.0.

Dettagli proprietà

authorizationToken

Ottiene/Imposta il token di autorizzazione. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido.

void authorizationToken

Valore della proprietà

void

endpointId

Ottiene l'ID endpoint di un modello di riconoscimento vocale personalizzato usato per il riconoscimento vocale.

string endpointId

Valore della proprietà

string

The endpoint ID

outputFormat

Ottiene il formato di output del riconoscimento vocale (semplice o dettagliato). Nota: questo formato di output è per il risultato del riconoscimento vocale, usare [SpeechConfig.speechSynthesisOutputFormat] per ottenere il formato di output audio sintetizzato.

OutputFormat outputFormat

Valore della proprietà

Restituisce il formato di output.

region

string region

Valore della proprietà

string

Area impostata sulla configurazione.

speechRecognitionLanguage

Ottiene/Imposta la lingua di riconoscimento vocale.

void speechRecognitionLanguage

Valore della proprietà

void

speechSynthesisLanguage

Ottiene la lingua del sintetizzatore vocale. Aggiunta nella versione 1.11.0.

string speechSynthesisLanguage

Valore della proprietà

string

Restituisce il linguaggio di sintesi vocale.

speechSynthesisOutputFormat

Ottiene il formato di output della sintesi vocale. Aggiunta nella versione 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Valore della proprietà

Restituisce il formato di output della sintesi vocale

speechSynthesisVoiceName

Ottiene la voce del sintetizzatore vocale. Aggiunta nella versione 1.11.0.

string speechSynthesisVoiceName

Valore della proprietà

string

Restituisce la voce di sintesi vocale.

subscriptionKey

string subscriptionKey

Valore della proprietà

string

Chiave di sottoscrizione impostata sulla configurazione.

targetLanguages

Ottiene la lingua di destinazione (testo) da tradurre.

string[] targetLanguages

Valore della proprietà

string[]

voiceName

Ottiene il nome voce selezionato.

string voiceName

Valore della proprietà

string

Nome voce.

Dettagli metodo

addTargetLanguage(string)

Aggiungere una lingua di destinazione (testo) da tradurre.

function addTargetLanguage(value: string)

Parametri

value

string

Lingua come de-DE

close()

Eliminare le risorse associate.

function close()

fromAuthorizationToken(string, string)

Istanza statica di SpeechTranslationConfig restituita passando il token di autorizzazione e l'area del servizio. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo impostando l'autorizzazione della proprietàToken con un nuovo token valido. In caso contrario, tutti i riconoscimento creati da questa istanza speechTranslationConfig riscontrano errori durante il riconoscimento. Man mano che i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscimento, il nuovo valore del token non verrà applicato ai riconoscimento già creati. Per i riconoscimento creati prima, è necessario impostare il token di autorizzazione del riconoscimento corrispondente per aggiornare il token. In caso contrario, i riconoscimento riscontrano errori durante il riconoscimento.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

Parametri

authorizationToken

string

Token di autorizzazione.

region

string

Nome area (vedere la pagina area).

Restituisce

Configurazione della traduzione vocale.

fromEndpoint(URL, string)

Crea un'istanza della configurazione della traduzione vocale con l'endpoint e la chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un endpoint di servizio non standard o paramters. Nota: le proprietà di query specificate nell'URL dell'endpoint non vengono modificate, anche se vengono impostate da qualsiasi altra API. Ad esempio, se il linguaggio è definito nell'URI come parametro di query "language=de-DE" e impostato anche dalla proprietà speechRecognitionLanguage, l'impostazione della lingua nell'uri ha la precedenza e il linguaggio effettivo è "de-DE". Solo le proprietà non specificate nell'URL dell'endpoint possono essere impostate da altre API. Nota: per usare il token di autorizzazione con fromEndpoint, passare una stringa vuota alla sottoscrizioneKey nel metodo fromEndpoint e quindi impostare authorizationToken="token" nell'istanza di SpeechConfig creata per usare il token di autorizzazione.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

Parametri

endpoint

URL

Endpoint del servizio a cui connettersi.

subscriptionKey

string

Chiave di sottoscrizione.

Restituisce

Istanza di configurazione voce.

fromHost(URL, string)

Crea un'istanza della configurazione del riconoscimento vocale con la chiave host e sottoscrizione specificata. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Verrà assunto il percorso delle risorse standard. Per i servizi con un percorso di risorse non standard o nessun percorso, usare invece fromEndpoint. Nota: i parametri di query non sono consentiti nell'URI host e devono essere impostati da altre API. Nota: per usare un token di autorizzazione con fromHost, usare fromHost(URL) e quindi impostare la proprietà AuthorizationToken nell'istanza di SpeechConfig creata. Nota: aggiunto nella versione 1.9.0.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

Parametri

hostName

URL

subscriptionKey

string

Chiave di sottoscrizione. Se non è specificata una chiave di sottoscrizione, è necessario impostare un token di autorizzazione.

Restituisce

Istanza di speech factory.

fromSubscription(string, string)

Istanza statica di SpeechTranslationConfig restituita passando una chiave di sottoscrizione e un'area del servizio.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

Parametri

subscriptionKey

string

Chiave di sottoscrizione.

region

string

Nome area (vedere la pagina area).

Restituisce

Configurazione della traduzione vocale.

setProperty(string | PropertyId, string)

Imposta una proprietà denominata come valore

function setProperty(name: string | PropertyId, value: string)

Parametri

name

string | PropertyId

Nome della proprietà da impostare.

value

string

Nuovo valore della proprietà.

Dettagli dei metodi ereditati

enableAudioLogging()

Abilitare la registrazione audio nel servizio. I log di audio e contenuto vengono archiviati nell'archiviazione di proprietà Microsoft o nell'account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (Bring Your Own Storage (BYOS) abilitata per la risorsa Voce. I log verranno rimossi dopo 30 giorni. Aggiunta nella versione 1.7.0.

function enableAudioLogging()

Ereditato daSpeechConfig.enableAudioLogging

enableDictation()

Abilitare la dettatura. Supportato solo nel riconoscimento vocale continuo. Aggiunta nella versione 1.7.0.

function enableDictation()

Ereditato daSpeechConfig.enableDictation

getProperty(string, string)

Restituisce il valore corrente di una proprietà arbitraria.

function getProperty(name: string, def?: string): string

Parametri

name

string

Nome della proprietà da eseguire una query.

def

string

Valore da restituire nel caso in cui la proprietà non sia nota.

Restituisce

string

Valore corrente, o specificato per impostazione predefinita, della proprietà specificata.

Ereditato daSpeechConfig.getProperty

requestWordLevelTimestamps()

Include timestamp a livello di parola. Aggiunta nella versione 1.7.0.

function requestWordLevelTimestamps()

Ereditato daSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Imposta l'opzione volgarità. Aggiunta nella versione 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parametri

profanity
ProfanityOption

Ereditato daSpeechConfig.setProfanity

setProxy(string, number)

Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parametri

proxyHostName

string

Nome host del server proxy.

proxyPort

number

Numero di porta del server proxy.

Ereditato daSpeechConfig.setProxy

setProxy(string, number, string, string)

Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Parametri

proxyHostName

string

Nome host del server proxy, senza lo schema di protocollo (http://)

proxyPort

number

Numero di porta del server proxy.

proxyUserName

string

Nome utente del server proxy.

proxyPassword

string

Password del server proxy.

Ereditato daSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Imposta un valore di proprietà che verrà passato al servizio usando il canale specificato. Aggiunta nella versione 1.7.0.

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

Parametri

name

string

value

string

Ereditato daSpeechConfig.setServiceProperty