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 bedoeld voor het resultaat van spraakherkenning. Gebruik [SpeechConfig.speechSynthesisOutputFormat] om een gesynthetiseerde audio-uitvoerindeling op te halen.
region
speechRecognitionLanguage

Retourneert de geconfigureerde taal.
speechSynthesisLanguage

Haalt 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

Krijgt de stem van de spraaksynthese. Toegevoegd in versie 1.11.0.
subscriptionKey

Methoden

close()

Hiermee sluit u de configuratie.
enableAudioLogging()

Schakel audiologboekregistratie in de service in. 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) waarvoor Spraakresource is ingeschakeld. De logboeken worden na 30 dagen verwijderd. Toegevoegd in versie 1.7.0.
enableDictation()

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

Hiermee maakt u een exemplaar van de spraakfactory met opgegeven initiële autorisatietoken en 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 Intentieherkenning wilt gebruiken. Omdat configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de waarde van het nieuwe token niet van toepassing op recognizers 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 treden de recognizers fouten op 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-standaardservice-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 de taal bijvoorbeeld is gedefinieerd in de URI als queryparameter "language=de-DE", en ook wordt ingesteld door SpeechConfig.speechRecognitionLanguage = "en-US", heeft de taalinstelling in URI voorrang en de effectieve taal is "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 methode fromEndpoint 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. Standaardresourcepad wordt ervan uitgegaan. Gebruik in plaats daarvan fromEndpoint voor services met een niet-standaardresourcepad of helemaal geen pad. 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 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 grof taalgebruik 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 bedoeld voor het resultaat van spraakherkenning. Gebruik [SpeechConfig.speechSynthesisOutputFormat] om een 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 op de configuratie.

speechRecognitionLanguage

Retourneert de geconfigureerde taal.

string speechRecognitionLanguage

Waarde van eigenschap

string

speechSynthesisLanguage

Haalt 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

Krijgt 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 op de configuratie.

Methodedetails

close()

Hiermee sluit u de configuratie.

function close()

enableAudioLogging()

Schakel audiologboekregistratie in de service in. 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) waarvoor Spraakresource is ingeschakeld. De logboeken worden na 30 dagen verwijderd. Toegevoegd in versie 1.7.0.

function enableAudioLogging()

enableDictation()

Dicteren inschakelen. Alleen ondersteund in spraak continue herkenning. Toegevoegd in versie 1.7.0.

function enableDictation()

fromAuthorizationToken(string, string)

Hiermee maakt u een exemplaar van de spraakfactory met opgegeven initiële autorisatietoken en 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 Intentieherkenning wilt gebruiken. Omdat configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de waarde van het nieuwe token niet van toepassing op recognizers 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 treden de recognizers fouten op tijdens de herkenning.

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

Parameters

authorizationToken

string

Het initiële autorisatietoken.

region

string

De regionaam (zie de pagina regio).

Retouren

SpeechConfig

Een exemplaar van een spraakfactory.

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-standaardservice-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 de taal bijvoorbeeld is gedefinieerd in de URI als queryparameter "language=de-DE", en ook wordt ingesteld door SpeechConfig.speechRecognitionLanguage = "en-US", heeft de taalinstelling in URI voorrang en de effectieve taal is "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 methode fromEndpoint 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 een autorisatietoken worden ingesteld.

Retouren

SpeechConfig

Een exemplaar van een spraakfactory.

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. Standaardresourcepad wordt ervan uitgegaan. Gebruik in plaats daarvan fromEndpoint voor services met een niet-standaardresourcepad of helemaal geen pad. 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 een autorisatietoken worden ingesteld.

Retouren

SpeechConfig

Een exemplaar van een spraakfactory.

fromSubscription(string, string)

Statisch exemplaar van SpeechConfig 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 pagina regio).

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 u wilt opvragen.

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 grof taalgebruik 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