SpeechTranslationConfig class
Configurazione della traduzione vocale.
- Extends
Proprietà
authorization |
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. |
endpoint |
Ottiene l'ID endpoint di un modello di riconoscimento vocale personalizzato usato per il riconoscimento vocale. |
output |
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 | |
speech |
Ottiene/Imposta la lingua di riconoscimento vocale. |
speech |
Ottiene la lingua del sintetizzatore vocale. Aggiunta nella versione 1.11.0. |
speech |
Ottiene il formato di output della sintesi vocale. Aggiunta nella versione 1.11.0. |
speech |
Ottiene la voce del sintetizzatore vocale. Aggiunta nella versione 1.11.0. |
subscription |
|
target |
Ottiene la lingua di destinazione (testo) da tradurre. |
voice |
Ottiene il nome voce selezionato. |
Metodi
add |
Aggiungere una lingua di destinazione (testo) da tradurre. |
close() | Eliminare le risorse associate. |
from |
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. |
from |
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. |
from |
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. |
from |
Istanza statica di SpeechTranslationConfig restituita passando una chiave di sottoscrizione e un'area del servizio. |
set |
Imposta una proprietà denominata come valore |
Metodi ereditati
enable |
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. |
enable |
Abilitare la dettatura. Supportato solo nel riconoscimento vocale continuo. Aggiunta nella versione 1.7.0. |
get |
Restituisce il valore corrente di una proprietà arbitraria. |
request |
Include timestamp a livello di parola. Aggiunta nella versione 1.7.0. |
set |
Imposta l'opzione volgarità. Aggiunta nella versione 1.7.0. |
set |
Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0. |
set |
Imposta la configurazione del proxy. Solo rilevanti negli ambienti Node.js. Aggiunta nella versione 1.4.0. |
set |
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
- channel
- UriQueryParameter
Ereditato daSpeechConfig.setServiceProperty