SpeechConfig class

Gets the authorization token. Gets/Sets the authorization token. Note: The caller needs to ensure that the authorization token is valid. Before the authorization token expires, the caller needs to refresh it by calling this setter with a new valid token.

string authorizationToken

Property Value

Gets the endpoint ID of a customized speech model that is used for speech recognition. Gets/Sets the endpoint ID of a customized speech model that is used for speech recognition.

string endpointId

Property Value

The endpoint ID

Gets speech recognition output format (simple or detailed). Note: This output format is for speech recognition result, use [SpeechConfig.speechSynthesisOutputFormat] to get synthesized audio output format. Gets/Sets speech recognition output format (simple or detailed). Note: This output format is for speech recognition result, use [SpeechConfig.speechSynthesisOutputFormat] to set synthesized audio output format.

OutputFormat outputFormat

Property Value

Returns the output format.

string region

Property Value

The region set on the config.

Returns the configured language. Gets/Sets the input language.

string speechRecognitionLanguage

Property Value

Gets the language of the speech synthesizer. Sets the language of the speech synthesizer.

string speechSynthesisLanguage

Property Value

Returns the speech synthesis language. Added in version 1.11.0.

Gets the speech synthesis output format. Sets the speech synthesis output format (e.g. Riff16Khz16BitMonoPcm).

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Property Value

Returns the speech synthesis output format Added in version 1.11.0.

Gets the voice of the speech synthesizer. Sets the voice of the speech synthesizer. (see available voices).

string speechSynthesisVoiceName

Property Value

Returns the speech synthesis voice. Added in version 1.11.0.

string subscriptionKey

Property Value

The subscription key set on the config.

Closes the configuration.

function close()

function enableAudioLogging()

function enableDictation()

Creates an instance of the speech factory with specified initial authorization token and region. Note: The caller needs to ensure that the authorization token is valid. Before the authorization token expires, the caller needs to refresh it by calling this setter with a new valid token. Note: Please use a token derived from your LanguageUnderstanding subscription key in case you want to use the Intent recognizer. As configuration values are copied when creating a new recognizer, the new token value will not apply to recognizers that have already been created. For recognizers that have been created before, you need to set authorization token of the corresponding recognizer to refresh the token. Otherwise, the recognizers will encounter errors during recognition.

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

Parameters

Returns

A speech factory instance.

Creates an instance of the speech config with specified endpoint and subscription key. This method is intended only for users who use a non-standard service endpoint or parameters. Note: Please use your LanguageUnderstanding subscription key in case you want to use the Intent recognizer. Note: The query parameters specified in the endpoint URL are not changed, even if they are set by any other APIs. For example, if language is defined in the uri as query parameter "language=de-DE", and also set by SpeechConfig.speechRecognitionLanguage = "en-US", the language setting in uri takes precedence, and the effective language is "de-DE". Only the parameters that are not specified in the endpoint URL can be set by other APIs. Note: To use authorization token with fromEndpoint, pass an empty string to the subscriptionKey in the fromEndpoint method, and then set authorizationToken="token" on the created SpeechConfig instance to use the authorization token.

static function fromEndpoint(endpoint: URL, subscriptionKey?: string)

Parameters

Returns

A speech factory instance.

Creates an instance of the speech config with specified host and subscription key. This method is intended only for users who use a non-default service host. Standard resource path will be assumed. For services with a non-standard resource path or no path at all, use fromEndpoint instead. Note: Query parameters are not allowed in the host URI and must be set by other APIs. Note: To use an authorization token with fromHost, use fromHost(URL), and then set the AuthorizationToken property on the created SpeechConfig instance. Note: Added in version 1.9.0.

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

Parameters

Returns

A speech factory instance.

Static instance of SpeechConfig returned by passing subscriptionKey and service region. Note: Please use your LanguageUnderstanding subscription key in case you want to use the Intent recognizer.

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

Parameters

Returns

The speech factory

Returns the current value of an arbitrary property.

function getProperty(name: string, def?: string)

Parameters

Returns

The current value, or provided default, of the given property.

function requestWordLevelTimestamps()

function setProfanity(profanity: ProfanityOption)

Parameters

Sets an arbitrary property.

function setProperty(name: string, value: string)

Parameters

Sets the proxy configuration. Only relevant in Node.js environments. Added in version 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parameters

Sets the proxy configuration. Only relevant in Node.js environments. Added in version 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Parameters

function setServiceProperty(name: string, value: string, channel: ServicePropertyChannel)

Parameters