SpeechTranslationConfig class

Pakket:

microsoft-cognitiveservices-speech-sdk

Configuratie van spraakomzetting.

Extends

SpeechConfig

Eigenschappen

authorizationToken	Hiermee wordt het autorisatietoken opgehaald/ingesteld. 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.
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	Hiermee wordt de taal voor spraakherkenning opgehaald/ingesteld.
speechSynthesisLanguage	Hiermee haalt u de taal van de spraaksynthesizer op. Toegevoegd in versie 1.11.0.
speechSynthesisOutputFormat	Hiermee haalt u de uitvoerindeling van de spraaksynthese op. Toegevoegd in versie 1.11.0.
speechSynthesisVoiceName	Krijgt de stem van de spraaksynthesizer. Toegevoegd in versie 1.11.0.
subscriptionKey
targetLanguages	Hiermee haalt u de (tekst)doeltaal op om in te vertalen.
voiceName	Hiermee haalt u de geselecteerde spraaknaam op.

Methoden

addTargetLanguage(string)	Voeg een (tekst)doeltaal toe om in te vertalen.
close()	Verwijder gekoppelde resources.
fromAuthorizationToken(string, string)	Statisch exemplaar van SpeechTranslationConfig geretourneerd door autorisatietoken en serviceregio door te geven. Opmerking: de aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door het eigenschap authorizationToken in te stellen met een nieuw geldig token. Anders zullen alle recognizers die door dit SpeechTranslationConfig-exemplaar zijn gemaakt, fouten ondervinden tijdens de herkenning. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende herkenning instellen om het token te vernieuwen. Anders zullen de recognizers fouten tegenkomen tijdens de herkenning.
fromEndpoint(URL, string)	Hiermee maakt u een exemplaar van de configuratie voor spraakomzetting met het opgegeven eindpunt en de abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaard service-eindpunt of paramters gebruiken. Opmerking: de query-eigenschappen die zijn opgegeven in de eindpunt-URL, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Als taal bijvoorbeeld in de URI is gedefinieerd als queryparameter 'language=de-DE', en ook is ingesteld door de eigenschap speechRecognitionLanguage, heeft de taalinstelling in URI voorrang en is de effectieve taal 'de-DE'. Alleen de eigenschappen 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. 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 SpeechTranslationConfig dat wordt geretourneerd door een abonnementssleutel en serviceregio door te geven.
setProperty(string | PropertyId, string)	Hiermee stelt u een benoemde eigenschap in als waarde

Overgenomen methoden

enableAudioLogging()	Audiologboekregistratie inschakelen in de service. Audio- en inhoudslogboeken worden opgeslagen in microsoft-opslag 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.
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 scheldwoorden in. Toegevoegd in versie 1.7.0.
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 wordt het autorisatietoken opgehaald/ingesteld. 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.

void authorizationToken

Waarde van eigenschap

void

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

Hiermee wordt de taal voor spraakherkenning opgehaald/ingesteld.

void speechRecognitionLanguage

Waarde van eigenschap

void

speechSynthesisLanguage

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

string speechSynthesisLanguage

Waarde van eigenschap

string

Retourneert de spraaksynthesetaal.

speechSynthesisOutputFormat

Hiermee haalt u de uitvoerindeling van de 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 spraaksynthesizer. 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.

targetLanguages

Hiermee haalt u de (tekst)doeltaal op om in te vertalen.

string[] targetLanguages

Waarde van eigenschap

string[]

voiceName

Hiermee haalt u de geselecteerde spraaknaam op.

string voiceName

Waarde van eigenschap

string

De naam van de stem.

Methodedetails

addTargetLanguage(string)

Voeg een (tekst)doeltaal toe om in te vertalen.

function addTargetLanguage(value: string)

Parameters

value

string

De taal zoals de-DE

close()

Verwijder gekoppelde resources.

function close()

fromAuthorizationToken(string, string)

Statisch exemplaar van SpeechTranslationConfig geretourneerd door autorisatietoken en serviceregio door te geven. Opmerking: de aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door het eigenschap authorizationToken in te stellen met een nieuw geldig token. Anders zullen alle recognizers die door dit SpeechTranslationConfig-exemplaar zijn gemaakt, fouten ondervinden tijdens de herkenning. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende herkenning instellen om het token te vernieuwen. Anders zullen de recognizers fouten tegenkomen tijdens de herkenning.

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

Parameters

authorizationToken

string

Het autorisatietoken.

region

string

De regionaam (zie de regiopagina).

Retouren

SpeechTranslationConfig

De configuratie van spraakomzetting.

fromEndpoint(URL, string)

Hiermee maakt u een exemplaar van de configuratie voor spraakomzetting met het opgegeven eindpunt en de abonnementssleutel. Deze methode is alleen bedoeld voor gebruikers die een niet-standaard service-eindpunt of paramters gebruiken. Opmerking: de query-eigenschappen die zijn opgegeven in de eindpunt-URL, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Als taal bijvoorbeeld in de URI is gedefinieerd als queryparameter 'language=de-DE', en ook is ingesteld door de eigenschap speechRecognitionLanguage, heeft de taalinstelling in URI voorrang en is de effectieve taal 'de-DE'. Alleen de eigenschappen 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): SpeechTranslationConfig

Parameters

endpoint

URL

Het service-eindpunt waarmee verbinding moet worden gemaakt.

subscriptionKey

string

De abonnementssleutel.

Retouren

SpeechTranslationConfig

Een exemplaar van spraakconfiguratie.

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 een autorisatietoken worden ingesteld.

Retouren

SpeechConfig

Een spraakfactory-exemplaar.

fromSubscription(string, string)

Statisch exemplaar van SpeechTranslationConfig dat wordt geretourneerd door een abonnementssleutel en serviceregio door te geven.

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

Parameters

subscriptionKey

string

De abonnementssleutel.

region

string

De regionaam (zie de regiopagina).

Retouren

SpeechTranslationConfig

De configuratie van spraakomzetting.

setProperty(string | PropertyId, string)

Hiermee stelt u een benoemde eigenschap in als waarde

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.

Details overgenomen methode

enableAudioLogging()

Audiologboekregistratie inschakelen in de service. Audio- en inhoudslogboeken worden opgeslagen in microsoft-opslag 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()

Overgenomen vanSpeechConfig.enableAudioLogging

enableDictation()

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

function enableDictation()

Overgenomen vanSpeechConfig.enableDictation

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 standaardwaarde, van de opgegeven eigenschap.

Overgenomen vanSpeechConfig.getProperty

requestWordLevelTimestamps()

Bevat tijdstempels op woordniveau. Toegevoegd in versie 1.7.0.

function requestWordLevelTimestamps()

Overgenomen vanSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Parameters

profanity

ProfanityOption

Overgenomen vanSpeechConfig.setProfanity

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.

Overgenomen vanSpeechConfig.setProxy

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.

Overgenomen vanSpeechConfig.setProxy

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

Overgenomen vanSpeechConfig.setServiceProperty