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. Než vyprší platnost autorizačního tokenu, volající ho 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, pomocí funkce [SpeechConfig.speechSynthesisOutputFormat] získejte syntetizovaný formát zvukového výstupu.
region
speechRecognitionLanguage	Získá nebo nastaví jazyk rozpoznávání řeči.
speechSynthesisLanguage	Získá jazyk syntetizá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 syntetizá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á vybraný název hlasu.

Metody

addTargetLanguage(string)	Přidejte cílový jazyk (text) pro překlad.
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 s novým platným tokenem. V opačném případě se během rozpoznávání zobrazí všechny rozpoznávací objekty vytvořené touto instancí SpeechTranslationConfig. Při vytváření nového rozpoznávatele se hodnoty konfigurace zkopírují, ale nová hodnota tokenu se nepoužije 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 pro aktualizaci tokenu. V opačném případě se při rozpoznávání budou narazit na chyby.
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čená 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í, i když 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 pomocí speechRecognitionLanguage vlastnost, má přednost nastavení jazyka v identifikátoru URI a efektivní jazyk je "de-DE". Jiná rozhraní API můžou nastavit pouze 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 do subscriptionKey v metodě fromEndpoint a potom nastavte authorizationToken="token" u vytvořené instance SpeechConfig tak, aby používal autorizační token.
fromHost(URL, string)	Vytvoří instanci konfigurace řeči se zadaným klíčem hostitele a předplatného. Tato metoda je určená pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta prostředku. Pro služby, které mají nestandardní cestu k prostředku nebo žádnou cestu, použijte místo toho zEndpointu. Poznámka: Parametry dotazu nejsou povoleny v identifikátoru URI hostitele a musí být nastaveny jinými rozhraními API. Poznámka: Chcete-li použít autorizační token s fromHost, použijte fromHost(URL) a pak nastavte AuthorizationToken vlastnost na 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ď v úložišti vlastněné Microsoftem, nebo ve vašem vlastním účtu úložiště propojeném s vaším předplatným služeb Cognitive Services (byOS) s povoleným prostředkem služby Speech (Bring Your Own Storage). Protokoly se odeberou po 30 dnech. Přidáno ve verzi 1.7.0.
enableDictation()	Povolte diktování. Podporuje se pouze v průběžné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()	Obsahuje časová razítka na úrovni slova. 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 prostředích Node.js. Přidáno ve verzi 1.4.0.
setProxy(string, number, string, string)	Nastaví konfiguraci proxy serveru. Relevantní pouze v prostředích Node.js. Přidáno ve verzi 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Nastaví hodnotu vlastnosti, která se předá 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. Než vyprší platnost autorizačního tokenu, volající ho 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, pomocí funkce [SpeechConfig.speechSynthesisOutputFormat] získejte syntetizovaný formát zvukového výstupu.

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 syntetizá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 syntetizá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ý na konfiguraci.

targetLanguages

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

string[] targetLanguages

Hodnota vlastnosti

string[]

voiceName

Získá vybraný název hlasu.

string voiceName

Hodnota vlastnosti

string

Jméno hlasu.

Podrobnosti metody

addTargetLanguage(string)

Přidejte cílový jazyk (text) pro překlad.

function addTargetLanguage(value: string)

Parametry

value

string

Jazyk, například 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 s novým platným tokenem. V opačném případě se během rozpoznávání zobrazí všechny rozpoznávací objekty vytvořené touto instancí SpeechTranslationConfig. Při vytváření nového rozpoznávatele se hodnoty konfigurace zkopírují, ale nová hodnota tokenu se nepoužije 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 pro aktualizaci tokenu. V opačném případě se při rozpoznávání budou narazit na chyby.

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čená 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í, i když 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 pomocí speechRecognitionLanguage vlastnost, má přednost nastavení jazyka v identifikátoru URI a efektivní jazyk je "de-DE". Jiná rozhraní API můžou nastavit pouze 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 do subscriptionKey v metodě fromEndpoint a potom nastavte authorizationToken="token" u vytvořené instance SpeechConfig tak, aby používal 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 klíčem hostitele a předplatného. Tato metoda je určená pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta prostředku. Pro služby, které mají nestandardní cestu k prostředku nebo žádnou cestu, použijte místo toho zEndpointu. Poznámka: Parametry dotazu nejsou povoleny v identifikátoru URI hostitele a musí být nastaveny jinými rozhraními API. Poznámka: Chcete-li použít autorizační token s fromHost, použijte fromHost(URL) a pak nastavte AuthorizationToken vlastnost na 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 není zadaný klíč předplatného, musí být nastavený autorizační token.

Návraty

SpeechConfig

Instance služby Speech Factory.

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, která se má 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ď v úložišti vlastněné Microsoftem, nebo ve vašem vlastním účtu úložiště propojeném s vaším předplatným služeb Cognitive Services (byOS) s povoleným prostředkem služby Speech (Bring Your Own Storage). 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í. Podporuje se pouze v průběžné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 dané vlastnosti nebo zadaná výchozí hodnota.

zděděno zSpeechConfig.getProperty

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

zděděné 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 z SpeechConfig.setProfanity

setProxy(string, number)

Nastaví konfiguraci proxy serveru. Relevantní pouze v prostředích Node.js. 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 z SpeechConfig.setProxy

setProxy(string, number, string, string)

Nastaví konfiguraci proxy serveru. Relevantní pouze v prostředích Node.js. 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 z SpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Nastaví hodnotu vlastnosti, která se předá 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