SpeechTranslationConfig class
Configurazione della traduzione vocale. SpeechTranslationConfig
- 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 utilizzato 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) in cui tradurre. |
| token |
Ottiene l'istanza di TokenCredential, se configurata. Disponibile solo se si usa l'autenticazione basata su AAD tramite TokenCredential. |
| voice |
Ottiene il nome della voce selezionata. |
Metodi
| add |
Aggiungere una lingua di destinazione (testo) in cui 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 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. |
| from |
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:
|
| 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 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. |
| from |
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. |
| 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 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. |
| enable |
Abilita 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. È rilevante solo negli ambienti Node.js. Aggiunta nella versione 1.4.0. |
| set |
Imposta la configurazione del proxy. È rilevante solo negli ambienti Node.js. Aggiunta nella versione 1.4.0. |
| set |
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
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
- channel
- UriQueryParameter
Ereditato daSpeechConfig.setServiceProperty