SpeechTranslationConfig class

Configurazione della traduzione vocale. SpeechTranslationConfig

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 utilizzato 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) in cui tradurre.

tokenCredential

Ottiene l'istanza di TokenCredential, se configurata. Disponibile solo se si usa l'autenticazione basata su AAD tramite TokenCredential.

voiceName

Ottiene il nome della voce selezionata.

Metodi

addTargetLanguage(string)

Aggiungere una lingua di destinazione (testo) in cui 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 la proprietà authorizationToken con un nuovo token valido. In caso contrario, tutti i riconoscitori creati da questa istanza di SpeechTranslationConfig riscontreranno errori durante il riconoscimento. Poiché i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscitore, il nuovo valore del token non verrà applicato ai riconoscitori che sono già stati creati. Per i riconoscitori creati in precedenza, è necessario impostare il token di autorizzazione del riconoscitore corrispondente per aggiornare il token. In caso contrario, i riconoscitori riscontrano errori durante il riconoscimento.

fromEndpoint(URL, KeyCredential | TokenCredential)

Crea un'istanza di una configurazione di traduzione vocale con un endpoint personalizzato e una credenziale. I parametri di query specificati nell'URI dell'endpoint non vengono modificati, anche se vengono impostati da qualsiasi altra chiamata API. Ad esempio, se la lingua di riconoscimento è definita nel parametro di query URI come "language=de-DE" e la proprietà SpeechRecognitionLanguage è impostata su "en-US", la lingua impostata nell'URI ha la precedenza e "de-DE" rimane la lingua prevista. Poiché i parametri inclusi nell'URI dell'endpoint hanno la priorità, solo i parametri che non sono specificati nell'URI dell'endpoint possono essere impostati da altre API. Tipi di credenziali supportati:

  • KeyCredential: per l'autenticazione basata su chiave API.
  • TokenCredential: per l'autenticazione basata su Azure AD. Nota: per usare il token di autorizzazione con fromEndpoint, passare una stringa vuota alla subscriptionKey nel metodo fromEndpoint e quindi impostare authorizationToken="token" nell'istanza di SpeechConfig creata per usare il token di autorizzazione.
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 parametri. Nota: le proprietà della query specificate nell'URL dell'endpoint non vengono modificate, anche se sono impostate da qualsiasi altra API. Ad esempio, se la lingua è definita nell'URI come parametro di query "language=de-DE", e anche impostata dalla proprietà speechRecognitionLanguage, l'impostazione della lingua nell'URI ha la precedenza e la lingua effettiva è "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 subscriptionKey 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 l'host e la chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Si presuppone il percorso della risorsa 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: aggiunta 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 audio e del contenuto vengono archiviati nella risorsa di archiviazione di proprietà di Microsoft o nel proprio account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (risorsa byos bring your own storage (BYOS) abilitata per il riconoscimento vocale. I log verranno rimossi dopo 30 giorni. Aggiunta nella versione 1.7.0.

enableDictation()

Abilita 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. È rilevante solo negli ambienti Node.js. Aggiunta nella versione 1.4.0.

setProxy(string, number, string, string)

Imposta la configurazione del proxy. È rilevante solo negli ambienti Node.js. Aggiunta nella versione 1.4.0.

setServiceProperty(string, string, UriQueryParameter)

Imposta un valore della 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 utilizzato per il riconoscimento vocale.

string endpointId

Valore della proprietà

string

L'ID dell'endpoint

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 nella configurazione.

targetLanguages

Ottiene la lingua di destinazione (testo) in cui tradurre.

string[] targetLanguages

Valore della proprietà

string[]

tokenCredential

Ottiene l'istanza di TokenCredential, se configurata. Disponibile solo se si usa l'autenticazione basata su AAD tramite TokenCredential.

TokenCredential | undefined tokenCredential

Valore della proprietà

TokenCredential | undefined

voiceName

Ottiene il nome della voce selezionata.

string voiceName

Valore della proprietà

string

Nome della voce.

Dettagli metodo

addTargetLanguage(string)

Aggiungere una lingua di destinazione (testo) in cui 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 la proprietà authorizationToken con un nuovo token valido. In caso contrario, tutti i riconoscitori creati da questa istanza di SpeechTranslationConfig riscontreranno errori durante il riconoscimento. Poiché i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscitore, il nuovo valore del token non verrà applicato ai riconoscitori che sono già stati creati. Per i riconoscitori creati in precedenza, è necessario impostare il token di autorizzazione del riconoscitore corrispondente per aggiornare il token. In caso contrario, i riconoscitori riscontrano errori durante il riconoscimento.

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

Parametri

authorizationToken

string

Token di autorizzazione.

region

string

Il nome della regione (vedere la pagina della regione).

Valori restituiti

Configurazione della traduzione vocale.

fromEndpoint(URL, KeyCredential | TokenCredential)

Crea un'istanza di una configurazione di traduzione vocale con un endpoint personalizzato e una credenziale. I parametri di query specificati nell'URI dell'endpoint non vengono modificati, anche se vengono impostati da qualsiasi altra chiamata API. Ad esempio, se la lingua di riconoscimento è definita nel parametro di query URI come "language=de-DE" e la proprietà SpeechRecognitionLanguage è impostata su "en-US", la lingua impostata nell'URI ha la precedenza e "de-DE" rimane la lingua prevista. Poiché i parametri inclusi nell'URI dell'endpoint hanno la priorità, solo i parametri che non sono specificati nell'URI dell'endpoint possono essere impostati da altre API. Tipi di credenziali supportati:

  • KeyCredential: per l'autenticazione basata su chiave API.
  • TokenCredential: per l'autenticazione basata su Azure AD. Nota: per usare il token di autorizzazione con fromEndpoint, passare una stringa vuota alla subscriptionKey nel metodo fromEndpoint e quindi impostare authorizationToken="token" nell'istanza di SpeechConfig creata per usare il token di autorizzazione.
static function fromEndpoint(endpoint: URL, credential: KeyCredential | TokenCredential): SpeechTranslationConfig

Parametri

endpoint

URL

Endpoint del servizio a cui connettersi.

credential

KeyCredential | TokenCredential

Le credenziali utilizzate per l'autenticazione.

Valori restituiti

Istanza di Speech Factory.

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 parametri. Nota: le proprietà della query specificate nell'URL dell'endpoint non vengono modificate, anche se sono impostate da qualsiasi altra API. Ad esempio, se la lingua è definita nell'URI come parametro di query "language=de-DE", e anche impostata dalla proprietà speechRecognitionLanguage, l'impostazione della lingua nell'URI ha la precedenza e la lingua effettiva è "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 subscriptionKey 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.

Valori restituiti

Un'istanza di configurazione della traduzione vocale.

fromHost(URL, string)

Crea un'istanza della configurazione del riconoscimento vocale con l'host e la chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Si presuppone il percorso della risorsa 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: aggiunta nella versione 1.9.0.

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

Parametri

hostName

URL

subscriptionKey

string

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

Valori restituiti

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

Il nome della regione (vedere la pagina della regione).

Valori restituiti

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 audio e del contenuto vengono archiviati nella risorsa di archiviazione di proprietà di Microsoft o nel proprio account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (risorsa byos bring your own storage (BYOS) abilitata per il riconoscimento vocale. I log verranno rimossi dopo 30 giorni. Aggiunta nella versione 1.7.0.

function enableAudioLogging()

Ereditato daSpeechConfig.enableAudioLogging

enableDictation()

Abilita 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à su cui eseguire una query.

def

string

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

Valori restituiti

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. È rilevante solo 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. È rilevante solo 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 del 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 della 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