SpeechTranslationConfig class

Pakiet:

microsoft-cognitiveservices-speech-sdk

Konfiguracja tłumaczenia mowy.

Extends

SpeechConfig

Właściwości

authorizationToken	Pobiera/ustawia token autoryzacji. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Przed wygaśnięciem tokenu autoryzacji obiekt wywołujący musi go odświeżyć, wywołując go przez wywołanie tego ustawiacza przy użyciu nowego prawidłowego tokenu.
endpointId	Pobiera identyfikator punktu końcowego dostosowanego modelu mowy, który jest używany do rozpoznawania mowy.
outputFormat	Pobiera format danych wyjściowych rozpoznawania mowy (prosty lub szczegółowy). Uwaga: Ten format danych wyjściowych jest przeznaczony dla wyniku rozpoznawania mowy, użyj polecenia [SpeechConfig.speechSynthesisOutputFormat], aby uzyskać syntetyzowany format danych wyjściowych dźwięku.
region
speechRecognitionLanguage	Pobiera/ustawia język rozpoznawania mowy.
speechSynthesisLanguage	Pobiera język syntezatora mowy. Dodano w wersji 1.11.0.
speechSynthesisOutputFormat	Pobiera format danych wyjściowych syntezy mowy. Dodano w wersji 1.11.0.
speechSynthesisVoiceName	Pobiera głos syntetyzatora mowy. Dodano w wersji 1.11.0.
subscriptionKey
targetLanguages	Pobiera język docelowy (tekst) do tłumaczenia.
voiceName	Pobiera wybraną nazwę głosu.

Metody

addTargetLanguage(string)	Dodaj język docelowy (tekst) do tłumaczenia.
close()	Usuwanie skojarzonych zasobów.
fromAuthorizationToken(string, string)	Wystąpienie statyczne elementu SpeechTranslationConfig zwrócone przez przekazanie tokenu autoryzacji i regionu usługi. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Przed wygaśnięciem tokenu autoryzacji obiekt wywołujący musi go odświeżyć, ustawiając token authorizationToken właściwości przy użyciu nowego prawidłowego tokenu. W przeciwnym razie wszystkie narzędzia rozpoznawania utworzone przez to wystąpienie speechTranslationConfig napotkają błędy podczas rozpoznawania. Ponieważ wartości konfiguracji są kopiowane podczas tworzenia nowego rozpoznawania, nowa wartość tokenu nie będzie stosowana do rozpoznawania, które zostały już utworzone. W przypadku rozpoznawania, które zostały utworzone wcześniej, należy ustawić token autoryzacji odpowiedniego rozpoznawania w celu odświeżenia tokenu. W przeciwnym razie osoby rozpoznające napotkają błędy podczas rozpoznawania.
fromEndpoint(URL, string)	Tworzy wystąpienie konfiguracji tłumaczenia mowy z określonym punktem końcowym i kluczem subskrypcji. Ta metoda jest przeznaczona tylko dla użytkowników, którzy używają standardowego punktu końcowego usługi lub parametrów. Uwaga: właściwości zapytania określone w adresie URL punktu końcowego nie są zmieniane, nawet jeśli są ustawione przez inne interfejsy API. Jeśli na przykład język jest zdefiniowany w identyfikatorze URI jako parametr zapytania "language=de-DE", a także ustawiony przez właściwość speechRecognitionLanguage, ustawienie języka w identyfikatorze URI ma pierwszeństwo, a efektywny język to "de-DE". Tylko właściwości, które nie zostały określone w adresie URL punktu końcowego, mogą być ustawiane przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z parametrem fromEndpoint, przekaż pusty ciąg do elementu subscriptionKey w metodzie fromEndpoint, a następnie ustaw wartość authorizationToken="token" w utworzonym wystąpieniu usługi SpeechConfig, aby użyć tokenu autoryzacji.
fromHost(URL, string)	Tworzy wystąpienie konfiguracji mowy z określonym hostem i kluczem subskrypcji. Ta metoda jest przeznaczona tylko dla użytkowników korzystających z hosta usługi innej niż domyślna. Założono, że zostanie założona standardowa ścieżka zasobu. W przypadku usług z niestandardową ścieżką zasobu lub bez żadnej ścieżki należy zamiast tego użyć metody fromEndpoint. Uwaga: parametry zapytania nie są dozwolone w identyfikatorze URI hosta i muszą być ustawiane przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z parametrem fromHost, użyj właściwości fromHost(URL), a następnie ustaw właściwość AuthorizationToken w utworzonym wystąpieniu usługi SpeechConfig. Uwaga: dodano element w wersji 1.9.0.
fromSubscription(string, string)	Wystąpienie statyczne elementu SpeechTranslationConfig zwrócone przez przekazanie klucza subskrypcji i regionu usługi.
setProperty(string | PropertyId, string)	Ustawia nazwaną właściwość jako wartość

Metody dziedziczone

enableAudioLogging()	Włącz rejestrowanie audio w usłudze. Dzienniki audio i zawartości są przechowywane w magazynie należącym do firmy Microsoft lub na własnym koncie magazynu połączonym z subskrypcją usług Cognitive Services (zasób usługi Mowa z włączoną usługą Bring Your Own Storage (BYOS). Dzienniki zostaną usunięte po upływie 30 dni. Dodano element w wersji 1.7.0.
enableDictation()	Włącz dyktowanie. Obsługiwane tylko w funkcji ciągłego rozpoznawania mowy. Dodano element w wersji 1.7.0.
getProperty(string, string)	Zwraca bieżącą wartość dowolnej właściwości.
requestWordLevelTimestamps()	Zawiera znaczniki czasu na poziomie wyrazów. Dodano element w wersji 1.7.0.
setProfanity(ProfanityOption)	Ustawia opcję wulgaryzmów. Dodano element w wersji 1.7.0.
setProxy(string, number)	Ustawia konfigurację serwera proxy. Istotne tylko w środowiskach Node.js. Dodano element w wersji 1.4.0.
setProxy(string, number, string, string)	Ustawia konfigurację serwera proxy. Istotne tylko w środowiskach Node.js. Dodano element w wersji 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Ustawia wartość właściwości, która zostanie przekazana do usługi przy użyciu określonego kanału. Dodano element w wersji 1.7.0.

Szczegóły właściwości

authorizationToken

Pobiera/ustawia token autoryzacji. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Przed wygaśnięciem tokenu autoryzacji obiekt wywołujący musi go odświeżyć, wywołując go przez wywołanie tego ustawiacza przy użyciu nowego prawidłowego tokenu.

void authorizationToken

Wartość właściwości

void

endpointId

Pobiera identyfikator punktu końcowego dostosowanego modelu mowy, który jest używany do rozpoznawania mowy.

string endpointId

Wartość właściwości

string

Identyfikator punktu końcowego

outputFormat

Pobiera format danych wyjściowych rozpoznawania mowy (prosty lub szczegółowy). Uwaga: Ten format danych wyjściowych jest przeznaczony dla wyniku rozpoznawania mowy, użyj polecenia [SpeechConfig.speechSynthesisOutputFormat], aby uzyskać syntetyzowany format danych wyjściowych dźwięku.

OutputFormat outputFormat

Wartość właściwości

OutputFormat

Zwraca format danych wyjściowych.

region

string region

Wartość właściwości

string

Region ustawiony w konfiguracji.

speechRecognitionLanguage

Pobiera/ustawia język rozpoznawania mowy.

void speechRecognitionLanguage

Wartość właściwości

void

speechSynthesisLanguage

Pobiera język syntezatora mowy. Dodano w wersji 1.11.0.

string speechSynthesisLanguage

Wartość właściwości

string

Zwraca język syntezy mowy.

speechSynthesisOutputFormat

Pobiera format danych wyjściowych syntezy mowy. Dodano w wersji 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Wartość właściwości

SpeechSynthesisOutputFormat

Zwraca format danych wyjściowych syntezy mowy

speechSynthesisVoiceName

Pobiera głos syntetyzatora mowy. Dodano w wersji 1.11.0.

string speechSynthesisVoiceName

Wartość właściwości

string

Zwraca głos syntezy mowy.

subscriptionKey

string subscriptionKey

Wartość właściwości

string

Klucz subskrypcji ustawiony w konfiguracji.

targetLanguages

Pobiera język docelowy (tekst) do tłumaczenia.

string[] targetLanguages

Wartość właściwości

string[]

voiceName

Pobiera wybraną nazwę głosu.

string voiceName

Wartość właściwości

string

Nazwa głosu.

Szczegóły metody

addTargetLanguage(string)

Dodaj język docelowy (tekst) do tłumaczenia.

function addTargetLanguage(value: string)

Parametry

value

string

Język, taki jak de-DE

close()

Usuwanie skojarzonych zasobów.

function close()

fromAuthorizationToken(string, string)

Wystąpienie statyczne elementu SpeechTranslationConfig zwrócone przez przekazanie tokenu autoryzacji i regionu usługi. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Przed wygaśnięciem tokenu autoryzacji obiekt wywołujący musi go odświeżyć, ustawiając token authorizationToken właściwości przy użyciu nowego prawidłowego tokenu. W przeciwnym razie wszystkie narzędzia rozpoznawania utworzone przez to wystąpienie speechTranslationConfig napotkają błędy podczas rozpoznawania. Ponieważ wartości konfiguracji są kopiowane podczas tworzenia nowego rozpoznawania, nowa wartość tokenu nie będzie stosowana do rozpoznawania, które zostały już utworzone. W przypadku rozpoznawania, które zostały utworzone wcześniej, należy ustawić token autoryzacji odpowiedniego rozpoznawania w celu odświeżenia tokenu. W przeciwnym razie osoby rozpoznające napotkają błędy podczas rozpoznawania.

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

Parametry

authorizationToken

string

Token autoryzacji.

region

string

Nazwa regionu (zobacz stronę regionów).

Zwraca

SpeechTranslationConfig

Konfiguracja tłumaczenia mowy.

fromEndpoint(URL, string)

Tworzy wystąpienie konfiguracji tłumaczenia mowy z określonym punktem końcowym i kluczem subskrypcji. Ta metoda jest przeznaczona tylko dla użytkowników, którzy używają standardowego punktu końcowego usługi lub parametrów. Uwaga: właściwości zapytania określone w adresie URL punktu końcowego nie są zmieniane, nawet jeśli są ustawione przez inne interfejsy API. Jeśli na przykład język jest zdefiniowany w identyfikatorze URI jako parametr zapytania "language=de-DE", a także ustawiony przez właściwość speechRecognitionLanguage, ustawienie języka w identyfikatorze URI ma pierwszeństwo, a efektywny język to "de-DE". Tylko właściwości, które nie zostały określone w adresie URL punktu końcowego, mogą być ustawiane przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z parametrem fromEndpoint, przekaż pusty ciąg do elementu subscriptionKey w metodzie fromEndpoint, a następnie ustaw wartość authorizationToken="token" w utworzonym wystąpieniu usługi SpeechConfig, aby użyć tokenu autoryzacji.

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

Parametry

endpoint

URL

Punkt końcowy usługi do nawiązania połączenia.

subscriptionKey

string

Klucz subskrypcji.

Zwraca

SpeechTranslationConfig

Wystąpienie konfiguracji mowy.

fromHost(URL, string)

Tworzy wystąpienie konfiguracji mowy z określonym hostem i kluczem subskrypcji. Ta metoda jest przeznaczona tylko dla użytkowników korzystających z hosta usługi innej niż domyślna. Założono, że zostanie założona standardowa ścieżka zasobu. W przypadku usług z niestandardową ścieżką zasobu lub bez żadnej ścieżki należy zamiast tego użyć metody fromEndpoint. Uwaga: parametry zapytania nie są dozwolone w identyfikatorze URI hosta i muszą być ustawiane przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z parametrem fromHost, użyj właściwości fromHost(URL), a następnie ustaw właściwość AuthorizationToken w utworzonym wystąpieniu usługi SpeechConfig. Uwaga: dodano element w wersji 1.9.0.

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

Parametry

hostName

URL

subscriptionKey

string

Klucz subskrypcji. Jeśli klucz subskrypcji nie zostanie określony, należy ustawić token autoryzacji.

Zwraca

SpeechConfig

Wystąpienie fabryki mowy.

fromSubscription(string, string)

Wystąpienie statyczne elementu SpeechTranslationConfig zwrócone przez przekazanie klucza subskrypcji i regionu usługi.

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

Parametry

subscriptionKey

string

Klucz subskrypcji.

region

string

Nazwa regionu (zobacz stronę regionów).

Zwraca

SpeechTranslationConfig

Konfiguracja tłumaczenia mowy.

setProperty(string | PropertyId, string)

Ustawia nazwaną właściwość jako wartość

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

Parametry

name

string | PropertyId

Nazwa właściwości do ustawienia.

value

string

Nowa wartość właściwości.

Szczegóły metody dziedziczonej

enableAudioLogging()

Włącz rejestrowanie audio w usłudze. Dzienniki audio i zawartości są przechowywane w magazynie należącym do firmy Microsoft lub na własnym koncie magazynu połączonym z subskrypcją usług Cognitive Services (zasób usługi Mowa z włączoną usługą Bring Your Own Storage (BYOS). Dzienniki zostaną usunięte po upływie 30 dni. Dodano element w wersji 1.7.0.

function enableAudioLogging()

Dziedziczone zobiektu SpeechConfig.enableAudioLogging

enableDictation()

Włącz dyktowanie. Obsługiwane tylko w funkcji ciągłego rozpoznawania mowy. Dodano element w wersji 1.7.0.

function enableDictation()

Dziedziczone zobiektu SpeechConfig.enableDictation

getProperty(string, string)

Zwraca bieżącą wartość dowolnej właściwości.

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

Parametry

name

string

Nazwa właściwości do kwerendy.

def

string

Wartość, która ma być zwracana w przypadku, gdy właściwość nie jest znana.

Zwraca

string

Bieżąca wartość lub podana wartość domyślna danej właściwości.

Dziedziczone zpliku SpeechConfig.getProperty

requestWordLevelTimestamps()

Zawiera znaczniki czasu na poziomie wyrazów. Dodano element w wersji 1.7.0.

function requestWordLevelTimestamps()

Dziedziczone zpliku SpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Ustawia opcję wulgaryzmów. Dodano element w wersji 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parametry

profanity

ProfanityOption

Dziedziczone zpliku SpeechConfig.setProfanity

setProxy(string, number)

Ustawia konfigurację serwera proxy. Istotne tylko w środowiskach Node.js. Dodano element w wersji 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parametry

proxyHostName

string

Nazwa hosta serwera proxy.

proxyPort

number

Numer portu serwera proxy.

Dziedziczone zobiektu SpeechConfig.setProxy

setProxy(string, number, string, string)

Ustawia konfigurację serwera proxy. Istotne tylko w środowiskach Node.js. Dodano element w wersji 1.4.0.

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

Parametry

proxyHostName

string

Nazwa hosta serwera proxy bez schematu protokołu (http://)

proxyPort

number

Numer portu serwera proxy.

proxyUserName

string

Nazwa użytkownika serwera proxy.

proxyPassword

string

Hasło serwera proxy.

Dziedziczone zobiektu SpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Ustawia wartość właściwości, która zostanie przekazana do usługi przy użyciu określonego kanału. Dodano element w wersji 1.7.0.

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

Parametry

name

string

value

string

channel

UriQueryParameter

Dziedziczone zspeechConfig.setServiceProperty