Condividi tramite

SpeechConfig class

  • Riferimento
Pacchetto:
microsoft-cognitiveservices-speech-sdk

Configurazione del riconoscimento vocale.

Proprietà

authorizationToken

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

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

Abilitare la dettatura. Supportato solo nel riconoscimento vocale continuo. Aggiunta nella versione 1.7.0.
fromAuthorizationToken(string, string)

Crea un'istanza della factory di riconoscimento 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 voglia usare lo strumento di riconoscimento finalità. 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, string)

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

string authorizationToken

Valore della proprietà

string

endpointId

Ottiene l'ID endpoint di un modello di riconoscimento vocale personalizzato utilizzato 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 nella configurazione.

Dettagli metodo

close()

Chiude la configurazione.

function close()

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

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 di riconoscimento 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 voglia usare lo strumento di riconoscimento finalità. 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): SpeechConfig

Parametri

authorizationToken

string

Token di autorizzazione iniziale.

region

string

Nome dell'area (vedere la pagina dell'area ).

Restituisce

SpeechConfig

Istanza di Speech Factory.

fromEndpoint(URL, string)

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

Parametri

endpoint

URL

Endpoint del servizio a cui connettersi.

subscriptionKey

string

Chiave di sottoscrizione. Se non viene 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 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): SpeechConfig

Parametri

hostName

URL

subscriptionKey

string

Chiave di sottoscrizione. Se non viene 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 voglia usare lo strumento di riconoscimento finalità.

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

Parametri

subscriptionKey

string

Chiave di sottoscrizione.

region

string

Nome dell'area (vedere la pagina dell'area ).

Restituisce

SpeechConfig

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à su cui 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. È 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.

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.

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