Condividi tramite

SpeechConfig class

  • Riferimento
Pacchetto:
microsoft-cognitiveservices-speech-sdk

Configurazione voce.

Proprietà

authorizationToken

Ottiene il token di autorizzazione.
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

Restituisce la lingua configurata.
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

Metodi

close()

Chiude la configurazione.
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.
fromAuthorizationToken(string, string)

Crea un'istanza della factory vocale con il token di autorizzazione iniziale e l'area specificati. 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. Nota: usare un token derivato dalla chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità. 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 del riconoscimento vocale con endpoint e chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un endpoint o parametri di servizio non standard. Nota: usare la chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità. Nota: i parametri di query specificati nell'URL dell'endpoint non vengono modificati, anche se vengono impostati da qualsiasi altra API. Ad esempio, se il linguaggio è definito nell'URI come parametro di query "language=de-DE", e anche impostato da SpeechConfig.speechRecognitionLanguage = "en-US", l'impostazione della lingua nell'uri ha la precedenza e il linguaggio effettivo è "de-DE". Solo i parametri non specificati nell'URL dell'endpoint possono essere impostati 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 SpeechConfig restituita passando subscriptionKey e area del servizio. Nota: usare la chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità.
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.
setProperty(string | PropertyId, string)

Imposta una proprietà arbitraria.
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 il token di autorizzazione.

string authorizationToken

Valore della proprietà

string

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à

OutputFormat

Restituisce il formato di output.

region 

string region

Valore della proprietà

string

Area impostata sulla configurazione.

speechRecognitionLanguage

Restituisce la lingua configurata.

string speechRecognitionLanguage

Valore della proprietà

string

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à

SpeechSynthesisOutputFormat

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.

Dettagli metodo

close()

Chiude la configurazione.

function close()

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()

enableDictation()

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

function enableDictation()

fromAuthorizationToken(string, string)

Crea un'istanza della factory vocale con il token di autorizzazione iniziale e l'area specificati. 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. Nota: usare un token derivato dalla chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità. 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): SpeechConfig

Parametri

authorizationToken

string

Token di autorizzazione iniziale.

region

string

Nome area (vedere la pagina area).

Restituisce

SpeechConfig

Istanza di speech factory.

fromEndpoint(URL, string)

Crea un'istanza della configurazione del riconoscimento vocale con endpoint e chiave di sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un endpoint o parametri di servizio non standard. Nota: usare la chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità. Nota: i parametri di query specificati nell'URL dell'endpoint non vengono modificati, anche se vengono impostati da qualsiasi altra API. Ad esempio, se il linguaggio è definito nell'URI come parametro di query "language=de-DE", e anche impostato da SpeechConfig.speechRecognitionLanguage = "en-US", l'impostazione della lingua nell'uri ha la precedenza e il linguaggio effettivo è "de-DE". Solo i parametri non specificati nell'URL dell'endpoint possono essere impostati 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): SpeechConfig

Parametri

endpoint

URL

Endpoint del servizio a cui connettersi.

subscriptionKey

string

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

Restituisce

SpeechConfig

Istanza di speech factory.

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

SpeechConfig

Istanza di speech factory.

fromSubscription(string, string)

Istanza statica di SpeechConfig restituita passando subscriptionKey e area del servizio. Nota: usare la chiave di sottoscrizione LanguageUnderstanding nel caso in cui si vuole usare il riconoscimento finalità.

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

Parametri

subscriptionKey

string

Chiave di sottoscrizione.

region

string

Nome area (vedere la pagina area).

Restituisce

SpeechConfig

La factory di riconoscimento vocale

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.

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Parametri

profanity
ProfanityOption

setProperty(string | PropertyId, string)

Imposta una proprietà arbitraria.

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

Parametri

name

string | PropertyId

Nome della proprietà da impostare.

value

string

Nuovo valore della proprietà.

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.

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.

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