SpeechTranslationConfig class

Balíček:

microsoft-cognitiveservices-speech-sdk

Konfigurace překladu řeči.

Extends

SpeechConfig

Vlastnosti

authorizationToken	Získá nebo nastaví autorizační token. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat zavoláním tohoto setteru s novým platným tokenem.
endpointId	Získá ID koncového bodu přizpůsobeného modelu řeči, který se používá pro rozpoznávání řeči.
outputFormat	Získá výstupní formát rozpoznávání řeči (jednoduchý nebo podrobný). Poznámka: Tento výstupní formát je určený pro výsledek rozpoznávání řeči. K získání syntetizovaného výstupního formátu zvuku použijte [SpeechConfig.speechSynthesisOutputFormat].
region
speechRecognitionLanguage	Získá nebo nastaví jazyk rozpoznávání řeči.
speechSynthesisLanguage	Získá jazyk syntezátoru řeči. Přidáno ve verzi 1.11.0.
speechSynthesisOutputFormat	Získá výstupní formát syntézy řeči. Přidáno ve verzi 1.11.0.
speechSynthesisVoiceName	Získá hlas syntezátoru řeči. Přidáno ve verzi 1.11.0.
subscriptionKey
targetLanguages	Získá cílový jazyk (text) k překladu.
voiceName	Získá název vybraného hlasu.

Metody

addTargetLanguage(string)	Přidejte cílový jazyk (text), do který chcete přeložit.
close()	Vyřaďte přidružené prostředky.
fromAuthorizationToken(string, string)	Statická instance SpeechTranslationConfig vrácená předáním autorizačního tokenu a oblasti služby. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat nastavením vlastnosti authorizationToken na nový platný token. V opačném případě všechny rozpoznávání vytvořené touto instancí SpeechTranslationConfig dorazí při rozpoznávání k chybám. Vzhledem k tomu, že se hodnoty konfigurace kopírují při vytváření nového rozpoznávání, nebude nová hodnota tokenu platit pro rozpoznávání, které už byly vytvořeny. Pro rozpoznávání, které byly vytvořeny dříve, musíte nastavit autorizační token odpovídajícího rozpoznávatele, aby se token aktualizoval. V opačném případě dojde při rozpoznávání k chybám.
fromEndpoint(URL, string)	Vytvoří instanci konfigurace překladu řeči se zadaným koncovým bodem a klíčem předplatného. Tato metoda je určena pouze pro uživatele, kteří používají nestandardní koncový bod služby nebo parametry. Poznámka: Vlastnosti dotazu zadané v adrese URL koncového bodu se nezmění, a to ani v případě, že jsou nastavené jinými rozhraními API. Pokud je například jazyk definován v identifikátoru URI jako parametr dotazu "language=de-DE" a také nastaven vlastností speechRecognitionLanguage, má nastavení jazyka v identifikátoru URI přednost a efektivní jazyk je "de-DE". Jiná rozhraní API můžou nastavit jenom vlastnosti, které nejsou zadané v adrese URL koncového bodu. Poznámka: Pokud chcete použít autorizační token s parametrem fromEndpoint, předejte prázdný řetězec subscriptionKey v metodě fromEndpoint a pak nastavte authorizationToken="token" ve vytvořené instanci SpeechConfig tak, aby používala autorizační token.
fromHost(URL, string)	Vytvoří instanci konfigurace řeči se zadaným hostitelem a klíčem předplatného. Tato metoda je určena pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta k prostředku. Pro služby s nestandardní cestou k prostředku nebo vůbec žádnou cestou použijte fromEndpoint. Poznámka: Parametry dotazu nejsou v identifikátoru URI hostitele povolené a musí je nastavit jiná rozhraní API. Poznámka: Pokud chcete použít autorizační token s parametrem fromHost, použijte fromHost(URL) a pak nastavte vlastnost AuthorizationToken ve vytvořené instanci SpeechConfig. Poznámka: Přidáno ve verzi 1.9.0.
fromSubscription(string, string)	Statická instance SpeechTranslationConfig vrácená předáním klíče předplatného a oblasti služby.
setProperty(string | PropertyId, string)	Nastaví pojmenovanou vlastnost jako hodnotu.

Zděděné metody

enableAudioLogging()	Povolte protokolování zvuku ve službě. Protokoly zvuku a obsahu se ukládají buď do úložiště vlastněného Microsoftem, nebo do vašeho vlastního účtu úložiště propojeného s vaším předplatným služeb Cognitive Services (přineste si vlastní úložiště (BYOS) s povoleným prostředkem Speech. Protokoly se odeberou po 30 dnech. Přidáno ve verzi 1.7.0.
enableDictation()	Povolte diktování. Podporováno pouze v nepřetržitém rozpoznávání řeči. Přidáno ve verzi 1.7.0.
getProperty(string, string)	Vrátí aktuální hodnotu libovolné vlastnosti.
requestWordLevelTimestamps()	Zahrnuje časová razítka na úrovni slov. Přidáno ve verzi 1.7.0.
setProfanity(ProfanityOption)	Nastaví možnost vulgárních výrazů. Přidáno ve verzi 1.7.0.
setProxy(string, number)	Nastaví konfiguraci proxy serveru. Relevantní pouze v Node.js prostředích. Přidáno ve verzi 1.4.0.
setProxy(string, number, string, string)	Nastaví konfiguraci proxy serveru. Relevantní pouze v Node.js prostředích. Přidáno ve verzi 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Nastaví hodnotu vlastnosti, která bude předána službě pomocí zadaného kanálu. Přidáno ve verzi 1.7.0.

Podrobnosti vlastnosti

authorizationToken

Získá nebo nastaví autorizační token. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat zavoláním tohoto setteru s novým platným tokenem.

void authorizationToken

Hodnota vlastnosti

void

endpointId

Získá ID koncového bodu přizpůsobeného modelu řeči, který se používá pro rozpoznávání řeči.

string endpointId

Hodnota vlastnosti

string

ID koncového bodu

outputFormat

Získá výstupní formát rozpoznávání řeči (jednoduchý nebo podrobný). Poznámka: Tento výstupní formát je určený pro výsledek rozpoznávání řeči. K získání syntetizovaného výstupního formátu zvuku použijte [SpeechConfig.speechSynthesisOutputFormat].

OutputFormat outputFormat

Hodnota vlastnosti

OutputFormat

Vrátí výstupní formát.

region

string region

Hodnota vlastnosti

string

Oblast nastavená v konfiguraci.

speechRecognitionLanguage

Získá nebo nastaví jazyk rozpoznávání řeči.

void speechRecognitionLanguage

Hodnota vlastnosti

void

speechSynthesisLanguage

Získá jazyk syntezátoru řeči. Přidáno ve verzi 1.11.0.

string speechSynthesisLanguage

Hodnota vlastnosti

string

Vrátí jazyk syntézy řeči.

speechSynthesisOutputFormat

Získá výstupní formát syntézy řeči. Přidáno ve verzi 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Hodnota vlastnosti

SpeechSynthesisOutputFormat

Vrátí výstupní formát syntézy řeči.

speechSynthesisVoiceName

Získá hlas syntezátoru řeči. Přidáno ve verzi 1.11.0.

string speechSynthesisVoiceName

Hodnota vlastnosti

string

Vrátí hlas syntézy řeči.

subscriptionKey

string subscriptionKey

Hodnota vlastnosti

string

Klíč předplatného nastavený v konfiguraci.

targetLanguages

Získá cílový jazyk (text) k překladu.

string[] targetLanguages

Hodnota vlastnosti

string[]

voiceName

Získá název vybraného hlasu.

string voiceName

Hodnota vlastnosti

string

Název hlasu.

Podrobnosti metody

addTargetLanguage(string)

Přidejte cílový jazyk (text), do který chcete přeložit.

function addTargetLanguage(value: string)

Parametry

value

string

Jazyk, jako je de-DE

close()

Vyřaďte přidružené prostředky.

function close()

fromAuthorizationToken(string, string)

Statická instance SpeechTranslationConfig vrácená předáním autorizačního tokenu a oblasti služby. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat nastavením vlastnosti authorizationToken na nový platný token. V opačném případě všechny rozpoznávání vytvořené touto instancí SpeechTranslationConfig dorazí při rozpoznávání k chybám. Vzhledem k tomu, že se hodnoty konfigurace kopírují při vytváření nového rozpoznávání, nebude nová hodnota tokenu platit pro rozpoznávání, které už byly vytvořeny. Pro rozpoznávání, které byly vytvořeny dříve, musíte nastavit autorizační token odpovídajícího rozpoznávatele, aby se token aktualizoval. V opačném případě dojde při rozpoznávání k chybám.

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

Parametry

authorizationToken

string

Autorizační token.

region

string

Název oblasti (viz stránka oblasti).

Návraty

SpeechTranslationConfig

Konfigurace překladu řeči

fromEndpoint(URL, string)

Vytvoří instanci konfigurace překladu řeči se zadaným koncovým bodem a klíčem předplatného. Tato metoda je určena pouze pro uživatele, kteří používají nestandardní koncový bod služby nebo parametry. Poznámka: Vlastnosti dotazu zadané v adrese URL koncového bodu se nezmění, a to ani v případě, že jsou nastavené jinými rozhraními API. Pokud je například jazyk definován v identifikátoru URI jako parametr dotazu "language=de-DE" a také nastaven vlastností speechRecognitionLanguage, má nastavení jazyka v identifikátoru URI přednost a efektivní jazyk je "de-DE". Jiná rozhraní API můžou nastavit jenom vlastnosti, které nejsou zadané v adrese URL koncového bodu. Poznámka: Pokud chcete použít autorizační token s parametrem fromEndpoint, předejte prázdný řetězec subscriptionKey v metodě fromEndpoint a pak nastavte authorizationToken="token" ve vytvořené instanci SpeechConfig tak, aby používala autorizační token.

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

Parametry

endpoint

URL

Koncový bod služby, ke kterému se chcete připojit.

subscriptionKey

string

Klíč předplatného.

Návraty

SpeechTranslationConfig

Instance konfigurace řeči

fromHost(URL, string)

Vytvoří instanci konfigurace řeči se zadaným hostitelem a klíčem předplatného. Tato metoda je určena pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta k prostředku. Pro služby s nestandardní cestou k prostředku nebo vůbec žádnou cestou použijte fromEndpoint. Poznámka: Parametry dotazu nejsou v identifikátoru URI hostitele povolené a musí je nastavit jiná rozhraní API. Poznámka: Pokud chcete použít autorizační token s parametrem fromHost, použijte fromHost(URL) a pak nastavte vlastnost AuthorizationToken ve vytvořené instanci SpeechConfig. Poznámka: Přidáno ve verzi 1.9.0.

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

Parametry

hostName

URL

subscriptionKey

string

Klíč předplatného. Pokud klíč předplatného není zadaný, musí být nastavený autorizační token.

Návraty

SpeechConfig

Instance objektu pro vytváření řeči

fromSubscription(string, string)

Statická instance SpeechTranslationConfig vrácená předáním klíče předplatného a oblasti služby.

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

Parametry

subscriptionKey

string

Klíč předplatného.

region

string

Název oblasti (viz stránka oblasti).

Návraty

SpeechTranslationConfig

Konfigurace překladu řeči

setProperty(string | PropertyId, string)

Nastaví pojmenovanou vlastnost jako hodnotu.

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

Parametry

name

string | PropertyId

Název vlastnosti, kterou chcete nastavit.

value

string

Nová hodnota vlastnosti.

Podrobnosti zděděných metod

enableAudioLogging()

Povolte protokolování zvuku ve službě. Protokoly zvuku a obsahu se ukládají buď do úložiště vlastněného Microsoftem, nebo do vašeho vlastního účtu úložiště propojeného s vaším předplatným služeb Cognitive Services (přineste si vlastní úložiště (BYOS) s povoleným prostředkem Speech. Protokoly se odeberou po 30 dnech. Přidáno ve verzi 1.7.0.

function enableAudioLogging()

Zděděno zSpeechConfig.enableAudioLogging

enableDictation()

Povolte diktování. Podporováno pouze v nepřetržitém rozpoznávání řeči. Přidáno ve verzi 1.7.0.

function enableDictation()

Zděděno zSpeechConfig.enableDictation

getProperty(string, string)

Vrátí aktuální hodnotu libovolné vlastnosti.

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

Parametry

name

string

Název vlastnosti, která se má dotazovat.

def

string

Hodnota, která se má vrátit v případě, že vlastnost není známa.

Návraty

string

Aktuální hodnota nebo zadaná výchozí hodnota dané vlastnosti.

Zděděno zSpeechConfig.getProperty

requestWordLevelTimestamps()

Zahrnuje časová razítka na úrovni slov. Přidáno ve verzi 1.7.0.

function requestWordLevelTimestamps()

Zděděno zSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Nastaví možnost vulgárních výrazů. Přidáno ve verzi 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parametry

profanity

ProfanityOption

Zděděno zSpeechConfig.setProfanity

setProxy(string, number)

Nastaví konfiguraci proxy serveru. Relevantní pouze v Node.js prostředích. Přidáno ve verzi 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parametry

proxyHostName

string

Název hostitele proxy serveru.

proxyPort

number

Číslo portu proxy serveru.

Zděděno zSpeechConfig.setProxy

setProxy(string, number, string, string)

Nastaví konfiguraci proxy serveru. Relevantní pouze v Node.js prostředích. Přidáno ve verzi 1.4.0.

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

Parametry

proxyHostName

string

Název hostitele proxy serveru bez schématu protokolu (http://)

proxyPort

number

Číslo portu proxy serveru.

proxyUserName

string

Uživatelské jméno proxy serveru.

proxyPassword

string

Heslo proxy serveru.

Zděděno zSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Nastaví hodnotu vlastnosti, která bude předána službě pomocí zadaného kanálu. Přidáno ve verzi 1.7.0.

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

Parametry

name

string

value

string

channel

UriQueryParameter

Zděděno zSpeechConfig.setServiceProperty