Delen via

SpeechConfig class

  • Referentie
Pakket:
microsoft-cognitiveservices-speech-sdk

Spraakconfiguratie.

Eigenschappen

authorizationToken

Hiermee haalt u het autorisatietoken op.
endpointId

Hiermee haalt u de eindpunt-id op van een aangepast spraakmodel dat wordt gebruikt voor spraakherkenning.
outputFormat

Hiermee haalt u de uitvoerindeling voor spraakherkenning op (eenvoudig of gedetailleerd). Opmerking: deze uitvoerindeling is voor spraakherkenningsresultaat. Gebruik [SpeechConfig.speechSynthesisOutputFormat] om de gesynthetiseerde audio-uitvoerindeling op te halen.
region
speechRecognitionLanguage

Retourneert de geconfigureerde taal.
speechSynthesisLanguage

Hiermee haalt u de taal van de spraaksynthese op. Toegevoegd in versie 1.11.0.
speechSynthesisOutputFormat

Hiermee haalt u de uitvoerindeling voor spraaksynthese op. Toegevoegd in versie 1.11.0.
speechSynthesisVoiceName

Hiermee krijgt u de stem van de spraaksynthese. Toegevoegd in versie 1.11.0.
subscriptionKey

Methoden

close()

Hiermee sluit u de configuratie.
enableAudioLogging()

Audiologboekregistratie inschakelen in de service. Audio- en inhoudslogboeken worden opgeslagen in opslag die eigendom is van Microsoft of in uw eigen opslagaccount dat is gekoppeld aan uw Cognitive Services-abonnement (Bring Your Own Storage (BYOS) ingeschakelde spraakresource). De logboeken worden na 30 dagen verwijderd. Toegevoegd in versie 1.7.0.
enableDictation()

Dicteren inschakelen. Alleen ondersteund in continue spraakherkenning. Toegevoegd in versie 1.7.0.
fromAuthorizationToken(string, string)

Hiermee maakt u een exemplaar van de spraakfactory met het initiële autorisatietoken en de opgegeven regio. Opmerking: de aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door deze setter aan te roepen met een nieuw geldig token. Opmerking: gebruik een token dat is afgeleid van uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op herkenningsservers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende recognizer instellen om het token te vernieuwen. Anders zullen de herkenningsfouten optreden tijdens de herkenning.
fromEndpoint(URL, string)

Hiermee maakt u een exemplaar van de spraakconfiguratie met het opgegeven eindpunt en de abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaard service-eindpunt of -parameters gebruiken. Opmerking: gebruik uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken. Opmerking: de queryparameters die zijn opgegeven in de eindpunt-URL, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Als taal bijvoorbeeld is gedefinieerd in de URI als queryparameter 'language=de-DE', en ook is ingesteld door SpeechConfig.speechRecognitionLanguage = 'en-US', heeft de taalinstelling in uri voorrang en is de effectieve taal 'de-DE'. Alleen de parameters die niet zijn opgegeven in de eindpunt-URL kunnen worden ingesteld door andere API's. Opmerking: als u een autorisatietoken wilt gebruiken met fromEndpoint, geeft u een lege tekenreeks door aan de subscriptionKey in de fromEndpoint-methode en stelt u vervolgens authorizationToken="token" in op het gemaakte SpeechConfig-exemplaar om het autorisatietoken te gebruiken.
fromHost(URL, string)

Hiermee maakt u een exemplaar van de spraakconfiguratie met de opgegeven host- en abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservicehost gebruiken. Er wordt uitgegaan van het standaardresourcepad. Voor services met een niet-standaard resourcepad of helemaal geen pad, gebruikt u fromEndpoint. Opmerking: Queryparameters zijn niet toegestaan in de host-URI en moeten worden ingesteld door andere API's. Opmerking: als u een autorisatietoken wilt gebruiken met fromHost, gebruikt u fromHost(URL) en stelt u vervolgens de eigenschap AuthorizationToken in op het gemaakte SpeechConfig-exemplaar. Opmerking: toegevoegd in versie 1.9.0.
fromSubscription(string, string)

Statisch exemplaar van SpeechConfig dat wordt geretourneerd door subscriptionKey en serviceregio door te geven. Opmerking: gebruik uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken.
getProperty(string, string)

Retourneert de huidige waarde van een willekeurige eigenschap.
requestWordLevelTimestamps()

Bevat tijdstempels op woordniveau. Toegevoegd in versie 1.7.0.
setProfanity(ProfanityOption)

Hiermee stelt u de optie voor scheldwoorden in. Toegevoegd in versie 1.7.0.
setProperty(string | PropertyId, string)

Hiermee stelt u een willekeurige eigenschap in.
setProxy(string, number)

Hiermee stelt u de proxyconfiguratie in. Alleen relevant in Node.js omgevingen. Toegevoegd in versie 1.4.0.
setProxy(string, number, string, string)

Hiermee stelt u de proxyconfiguratie in. Alleen relevant in Node.js omgevingen. Toegevoegd in versie 1.4.0.
setServiceProperty(string, string, UriQueryParameter)

Hiermee stelt u een eigenschapswaarde in die wordt doorgegeven aan de service met behulp van het opgegeven kanaal. Toegevoegd in versie 1.7.0.

Eigenschapdetails

authorizationToken

Hiermee haalt u het autorisatietoken op.

string authorizationToken

Waarde van eigenschap

string

endpointId

Hiermee haalt u de eindpunt-id op van een aangepast spraakmodel dat wordt gebruikt voor spraakherkenning.

string endpointId

Waarde van eigenschap

string

De eindpunt-id

outputFormat

Hiermee haalt u de uitvoerindeling voor spraakherkenning op (eenvoudig of gedetailleerd). Opmerking: deze uitvoerindeling is voor spraakherkenningsresultaat. Gebruik [SpeechConfig.speechSynthesisOutputFormat] om de gesynthetiseerde audio-uitvoerindeling op te halen.

OutputFormat outputFormat

Waarde van eigenschap

OutputFormat

Retourneert de uitvoerindeling.

region 

string region

Waarde van eigenschap

string

De regio die is ingesteld voor de configuratie.

speechRecognitionLanguage

Retourneert de geconfigureerde taal.

string speechRecognitionLanguage

Waarde van eigenschap

string

speechSynthesisLanguage

Hiermee haalt u de taal van de spraaksynthese op. Toegevoegd in versie 1.11.0.

string speechSynthesisLanguage

Waarde van eigenschap

string

Retourneert de spraaksynthesetaal.

speechSynthesisOutputFormat

Hiermee haalt u de uitvoerindeling voor spraaksynthese op. Toegevoegd in versie 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Waarde van eigenschap

SpeechSynthesisOutputFormat

Retourneert de uitvoerindeling voor spraaksynthese

speechSynthesisVoiceName

Hiermee krijgt u de stem van de spraaksynthese. Toegevoegd in versie 1.11.0.

string speechSynthesisVoiceName

Waarde van eigenschap

string

Retourneert de spraaksynthesestem.

subscriptionKey 

string subscriptionKey

Waarde van eigenschap

string

De abonnementssleutel die is ingesteld voor de configuratie.

Methodedetails

close()

Hiermee sluit u de configuratie.

function close()

enableAudioLogging()

Audiologboekregistratie inschakelen in de service. Audio- en inhoudslogboeken worden opgeslagen in opslag die eigendom is van Microsoft of in uw eigen opslagaccount dat is gekoppeld aan uw Cognitive Services-abonnement (Bring Your Own Storage (BYOS) ingeschakelde spraakresource). De logboeken worden na 30 dagen verwijderd. Toegevoegd in versie 1.7.0.

function enableAudioLogging()

enableDictation()

Dicteren inschakelen. Alleen ondersteund in continue spraakherkenning. Toegevoegd in versie 1.7.0.

function enableDictation()

fromAuthorizationToken(string, string)

Hiermee maakt u een exemplaar van de spraakfactory met het initiële autorisatietoken en de opgegeven regio. Opmerking: de aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door deze setter aan te roepen met een nieuw geldig token. Opmerking: gebruik een token dat is afgeleid van uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op herkenningsservers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende recognizer instellen om het token te vernieuwen. Anders zullen de herkenningsfouten optreden tijdens de herkenning.

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

Parameters

authorizationToken

string

Het initiële autorisatietoken.

region

string

De regionaam (zie de regiopagina).

Retouren

SpeechConfig

Een spraakfactory-exemplaar.

fromEndpoint(URL, string)

Hiermee maakt u een exemplaar van de spraakconfiguratie met het opgegeven eindpunt en de abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaard service-eindpunt of -parameters gebruiken. Opmerking: gebruik uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken. Opmerking: de queryparameters die zijn opgegeven in de eindpunt-URL, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Als taal bijvoorbeeld is gedefinieerd in de URI als queryparameter 'language=de-DE', en ook is ingesteld door SpeechConfig.speechRecognitionLanguage = 'en-US', heeft de taalinstelling in uri voorrang en is de effectieve taal 'de-DE'. Alleen de parameters die niet zijn opgegeven in de eindpunt-URL kunnen worden ingesteld door andere API's. Opmerking: als u een autorisatietoken wilt gebruiken met fromEndpoint, geeft u een lege tekenreeks door aan de subscriptionKey in de fromEndpoint-methode en stelt u vervolgens authorizationToken="token" in op het gemaakte SpeechConfig-exemplaar om het autorisatietoken te gebruiken.

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

Parameters

endpoint

URL

Het service-eindpunt waarmee verbinding moet worden gemaakt.

subscriptionKey

string

De abonnementssleutel. Als er geen abonnementssleutel is opgegeven, moet er een autorisatietoken worden ingesteld.

Retouren

SpeechConfig

Een spraakfactory-exemplaar.

fromHost(URL, string)

Hiermee maakt u een exemplaar van de spraakconfiguratie met de opgegeven host- en abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservicehost gebruiken. Er wordt uitgegaan van het standaardresourcepad. Voor services met een niet-standaard resourcepad of helemaal geen pad, gebruikt u fromEndpoint. Opmerking: Queryparameters zijn niet toegestaan in de host-URI en moeten worden ingesteld door andere API's. Opmerking: als u een autorisatietoken wilt gebruiken met fromHost, gebruikt u fromHost(URL) en stelt u vervolgens de eigenschap AuthorizationToken in op het gemaakte SpeechConfig-exemplaar. Opmerking: toegevoegd in versie 1.9.0.

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

Parameters

hostName

URL

subscriptionKey

string

De abonnementssleutel. Als er geen abonnementssleutel is opgegeven, moet er een autorisatietoken worden ingesteld.

Retouren

SpeechConfig

Een spraakfactory-exemplaar.

fromSubscription(string, string)

Statisch exemplaar van SpeechConfig dat wordt geretourneerd door subscriptionKey en serviceregio door te geven. Opmerking: gebruik uw LanguageUnderstanding-abonnementssleutel voor het geval u de Intent Recognizer wilt gebruiken.

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

Parameters

subscriptionKey

string

De abonnementssleutel.

region

string

De regionaam (zie de regiopagina).

Retouren

SpeechConfig

De spraakfactory

getProperty(string, string)

Retourneert de huidige waarde van een willekeurige eigenschap.

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

Parameters

name

string

De naam van de eigenschap die moet worden opgevraagd.

def

string

De waarde die moet worden geretourneerd als de eigenschap niet bekend is.

Retouren

string

De huidige waarde, of de opgegeven standaardwaarde, van de opgegeven eigenschap.

requestWordLevelTimestamps()

Bevat tijdstempels op woordniveau. Toegevoegd in versie 1.7.0.

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

Hiermee stelt u de optie voor scheldwoorden in. Toegevoegd in versie 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parameters

profanity
ProfanityOption

setProperty(string | PropertyId, string)

Hiermee stelt u een willekeurige eigenschap in.

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

Parameters

name

string | PropertyId

De naam van de eigenschap die moet worden ingesteld.

value

string

De nieuwe waarde van de eigenschap.

setProxy(string, number)

Hiermee stelt u de proxyconfiguratie in. Alleen relevant in Node.js omgevingen. Toegevoegd in versie 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parameters

proxyHostName

string

De hostnaam van de proxyserver.

proxyPort

number

Het poortnummer van de proxyserver.

setProxy(string, number, string, string)

Hiermee stelt u de proxyconfiguratie in. Alleen relevant in Node.js omgevingen. Toegevoegd in versie 1.4.0.

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

Parameters

proxyHostName

string

De hostnaam van de proxyserver, zonder het protocolschema (http://)

proxyPort

number

Het poortnummer van de proxyserver.

proxyUserName

string

De gebruikersnaam van de proxyserver.

proxyPassword

string

Het wachtwoord van de proxyserver.

setServiceProperty(string, string, UriQueryParameter)

Hiermee stelt u een eigenschapswaarde in die wordt doorgegeven aan de service met behulp van het opgegeven kanaal. Toegevoegd in versie 1.7.0.

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

Parameters

name

string

value

string

channel
UriQueryParameter