Share via

SpeechConfig class

  • Referens
Paket:
microsoft-cognitiveservices-speech-sdk

Talkonfiguration.

Egenskaper

authorizationToken

Hämtar auktoriseringstoken.
endpointId

Hämtar slutpunkts-ID:t för en anpassad talmodell som används för taligenkänning.
outputFormat

Hämtar utdataformatet för taligenkänning (enkelt eller detaljerat). Obs! Det här utdataformatet är för taligenkänningsresultat. Använd [SpeechConfig.speechSynthesisOutputFormat] för att hämta syntetiserat ljudutdataformat.
region
speechRecognitionLanguage

Returnerar det konfigurerade språket.
speechSynthesisLanguage

Hämtar talsyntesens språk. Har lagts till i version 1.11.0.
speechSynthesisOutputFormat

Hämtar talsyntesens utdataformat. Har lagts till i version 1.11.0.
speechSynthesisVoiceName

Hämtar talsyntesens röst. Har lagts till i version 1.11.0.
subscriptionKey

Metoder

close()

Stänger konfigurationen.
enableAudioLogging()

Aktivera ljudloggning i tjänsten. Ljud- och innehållsloggar lagras antingen i Microsoft-ägd lagring eller i ditt eget lagringskonto som är länkat till din Cognitive Services-prenumeration (BYOS-aktiverad Speech-resurs med Bring Your Own Storage). Loggarna tas bort efter 30 dagar. Har lagts till i version 1.7.0.
enableDictation()

Aktivera diktering. Stöds endast vid kontinuerlig taligenkänning. Har lagts till i version 1.7.0.
fromAuthorizationToken(string, string)

Skapar en instans av talfabriken med angiven inledande auktoriseringstoken och region. Obs! Anroparen måste se till att auktoriseringstoken är giltig. Innan auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här inställningen med en ny giltig token. Obs! Använd en token som härletts från din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen. När konfigurationsvärden kopieras när du skapar en ny identifierare gäller inte det nya tokenvärdet för identifierare som redan har skapats. För identifierare som har skapats tidigare måste du ange auktoriseringstoken för motsvarande identifierare för att uppdatera token. Annars kommer identifierarna att stöta på fel under igenkänningen.
fromEndpoint(URL, string)

Skapar en instans av talkonfigurationen med angiven slutpunkt och prenumerationsnyckel. Den här metoden är endast avsedd för användare som använder en tjänstslutpunkt eller parametrar som inte är standard. Obs! Använd din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen. Obs! Frågeparametrarna som anges i slutpunkts-URL:en ändras inte, även om de anges av andra API:er. Om språket till exempel definieras i URI som frågeparametern "language=de-DE" och även anges av SpeechConfig.speechRecognitionLanguage = "en-US" har språkinställningen i URI företräde och det effektiva språket är "de-DE". Endast de parametrar som inte anges i slutpunkts-URL:en kan anges av andra API:er. Obs! Om du vill använda auktoriseringstoken med fromEndpoint skickar du en tom sträng till subscriptionKey i fromEndpoint-metoden och anger sedan authorizationToken="token" på den skapade SpeechConfig-instansen för att använda auktoriseringstoken.
fromHost(URL, string)

Skapar en instans av talkonfigurationen med angiven värd- och prenumerationsnyckel. Den här metoden är endast avsedd för användare som använder en tjänstvärd som inte är standard. Standardresurssökvägen antas. För tjänster med en icke-standardresurssökväg eller ingen sökväg alls använder du fromEndpoint i stället. Obs! Frågeparametrar tillåts inte i värd-URI:n och måste anges av andra API:er. Obs! Om du vill använda en auktoriseringstoken med fromHost använder du fromHost(URL) och anger sedan egenskapen AuthorizationToken på den skapade SpeechConfig-instansen. Obs! Tillagd i version 1.9.0.
fromSubscription(string, string)

Statisk instans av SpeechConfig som returneras genom att skicka subscriptionKey och tjänstregion. Obs! Använd din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen.
getProperty(string, string)

Returnerar det aktuella värdet för en godtycklig egenskap.
requestWordLevelTimestamps()

Innehåller tidsstämplar på ordnivå. Har lagts till i version 1.7.0.
setProfanity(ProfanityOption)

Anger alternativet för olämpligt språk. Har lagts till i version 1.7.0.
setProperty(string | PropertyId, string)

Anger en godtycklig egenskap.
setProxy(string, number)

Anger proxykonfigurationen. Endast relevant i Node.js miljöer. Har lagts till i version 1.4.0.
setProxy(string, number, string, string)

Anger proxykonfigurationen. Endast relevant i Node.js miljöer. Har lagts till i version 1.4.0.
setServiceProperty(string, string, UriQueryParameter)

Anger ett egenskapsvärde som ska skickas till tjänsten med hjälp av den angivna kanalen. Har lagts till i version 1.7.0.

Egenskapsinformation

authorizationToken

Hämtar auktoriseringstoken.

string authorizationToken

Egenskapsvärde

string

endpointId

Hämtar slutpunkts-ID:t för en anpassad talmodell som används för taligenkänning.

string endpointId

Egenskapsvärde

string

Slutpunkts-ID

outputFormat

Hämtar utdataformatet för taligenkänning (enkelt eller detaljerat). Obs! Det här utdataformatet är för taligenkänningsresultat. Använd [SpeechConfig.speechSynthesisOutputFormat] för att hämta syntetiserat ljudutdataformat.

OutputFormat outputFormat

Egenskapsvärde

OutputFormat

Returnerar utdataformatet.

region 

string region

Egenskapsvärde

string

Den region som angetts för konfigurationen.

speechRecognitionLanguage

Returnerar det konfigurerade språket.

string speechRecognitionLanguage

Egenskapsvärde

string

speechSynthesisLanguage

Hämtar talsyntesens språk. Har lagts till i version 1.11.0.

string speechSynthesisLanguage

Egenskapsvärde

string

Returnerar talsyntesspråket.

speechSynthesisOutputFormat

Hämtar talsyntesens utdataformat. Har lagts till i version 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Egenskapsvärde

SpeechSynthesisOutputFormat

Returnerar talsyntesens utdataformat

speechSynthesisVoiceName

Hämtar talsyntesens röst. Har lagts till i version 1.11.0.

string speechSynthesisVoiceName

Egenskapsvärde

string

Returnerar talsyntesrösten.

subscriptionKey 

string subscriptionKey

Egenskapsvärde

string

Prenumerationsnyckeln har angetts för konfigurationen.

Metodinformation

close()

Stänger konfigurationen.

function close()

enableAudioLogging()

Aktivera ljudloggning i tjänsten. Ljud- och innehållsloggar lagras antingen i Microsoft-ägd lagring eller i ditt eget lagringskonto som är länkat till din Cognitive Services-prenumeration (BYOS-aktiverad Speech-resurs med Bring Your Own Storage). Loggarna tas bort efter 30 dagar. Har lagts till i version 1.7.0.

function enableAudioLogging()

enableDictation()

Aktivera diktering. Stöds endast vid kontinuerlig taligenkänning. Har lagts till i version 1.7.0.

function enableDictation()

fromAuthorizationToken(string, string)

Skapar en instans av talfabriken med angiven inledande auktoriseringstoken och region. Obs! Anroparen måste se till att auktoriseringstoken är giltig. Innan auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här inställningen med en ny giltig token. Obs! Använd en token som härletts från din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen. När konfigurationsvärden kopieras när du skapar en ny identifierare gäller inte det nya tokenvärdet för identifierare som redan har skapats. För identifierare som har skapats tidigare måste du ange auktoriseringstoken för motsvarande identifierare för att uppdatera token. Annars kommer identifierarna att stöta på fel under igenkänningen.

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

Parametrar

authorizationToken

string

Den första auktoriseringstoken.

region

string

Regionnamnet (se regionsidan).

Returer

SpeechConfig

En speech factory-instans.

fromEndpoint(URL, string)

Skapar en instans av talkonfigurationen med angiven slutpunkt och prenumerationsnyckel. Den här metoden är endast avsedd för användare som använder en tjänstslutpunkt eller parametrar som inte är standard. Obs! Använd din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen. Obs! Frågeparametrarna som anges i slutpunkts-URL:en ändras inte, även om de anges av andra API:er. Om språket till exempel definieras i URI som frågeparametern "language=de-DE" och även anges av SpeechConfig.speechRecognitionLanguage = "en-US" har språkinställningen i URI företräde och det effektiva språket är "de-DE". Endast de parametrar som inte anges i slutpunkts-URL:en kan anges av andra API:er. Obs! Om du vill använda auktoriseringstoken med fromEndpoint skickar du en tom sträng till subscriptionKey i fromEndpoint-metoden och anger sedan authorizationToken="token" på den skapade SpeechConfig-instansen för att använda auktoriseringstoken.

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

Parametrar

endpoint

URL

Tjänstslutpunkten som du vill ansluta till.

subscriptionKey

string

Prenumerationsnyckeln. Om en prenumerationsnyckel inte anges måste en auktoriseringstoken anges.

Returer

SpeechConfig

En speech factory-instans.

fromHost(URL, string)

Skapar en instans av talkonfigurationen med angiven värd- och prenumerationsnyckel. Den här metoden är endast avsedd för användare som använder en tjänstvärd som inte är standard. Standardresurssökvägen antas. För tjänster med en icke-standardresurssökväg eller ingen sökväg alls använder du fromEndpoint i stället. Obs! Frågeparametrar tillåts inte i värd-URI:n och måste anges av andra API:er. Obs! Om du vill använda en auktoriseringstoken med fromHost använder du fromHost(URL) och anger sedan egenskapen AuthorizationToken på den skapade SpeechConfig-instansen. Obs! Tillagd i version 1.9.0.

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

Parametrar

hostName

URL

subscriptionKey

string

Prenumerationsnyckeln. Om en prenumerationsnyckel inte anges måste en auktoriseringstoken anges.

Returer

SpeechConfig

En speech factory-instans.

fromSubscription(string, string)

Statisk instans av SpeechConfig som returneras genom att skicka subscriptionKey och tjänstregion. Obs! Använd din LanguageUnderstanding-prenumerationsnyckel om du vill använda avsiktsigenkänningen.

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

Parametrar

subscriptionKey

string

Prenumerationsnyckeln.

region

string

Regionnamnet (se regionsidan).

Returer

SpeechConfig

Talfabriken

getProperty(string, string)

Returnerar det aktuella värdet för en godtycklig egenskap.

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

Parametrar

name

string

Namnet på egenskapen som ska frågas.

def

string

Värdet som ska returneras om egenskapen inte är känd.

Returer

string

Det aktuella värdet, eller det angivna standardvärdet, för den angivna egenskapen.

requestWordLevelTimestamps()

Innehåller tidsstämplar på ordnivå. Har lagts till i version 1.7.0.

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

Anger alternativet för olämpligt språk. Har lagts till i version 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parametrar

profanity
ProfanityOption

setProperty(string | PropertyId, string)

Anger en godtycklig egenskap.

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

Parametrar

name

string | PropertyId

Namnet på den egenskap som ska anges.

value

string

Det nya värdet för egenskapen.

setProxy(string, number)

Anger proxykonfigurationen. Endast relevant i Node.js miljöer. Har lagts till i version 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parametrar

proxyHostName

string

Proxyserverns värdnamn.

proxyPort

number

Proxyserverns portnummer.

setProxy(string, number, string, string)

Anger proxykonfigurationen. Endast relevant i Node.js miljöer. Har lagts till i version 1.4.0.

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

Parametrar

proxyHostName

string

Värdnamnet för proxyservern, utan protokollschemat (http://)

proxyPort

number

Proxyserverns portnummer.

proxyUserName

string

Användarnamnet för proxyservern.

proxyPassword

string

Lösenordet för proxyservern.

setServiceProperty(string, string, UriQueryParameter)

Anger ett egenskapsvärde som ska skickas till tjänsten med hjälp av den angivna kanalen. Har lagts till i version 1.7.0.

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

Parametrar

name

string

value

string

channel
UriQueryParameter