SpeechTranslationConfig class

Pakiet:

microsoft-cognitiveservices-speech-sdk

Konfiguracja tłumaczenia mowy.

Rozszerzenie

SpeechConfig

Właściwości

authorizationToken	Pobiera/ustawia token autoryzacji. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Zanim token autoryzacji wygaśnie, obiekt wywołujący musi go odświeżyć, wywołując ten setter z nowym prawidłowym tokenem.
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 wyjściowy 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 element w wersji 1.11.0.
speechSynthesisOutputFormat	Pobiera format danych wyjściowych syntezy mowy. Dodano element w wersji 1.11.0.
speechSynthesisVoiceName	Pobiera głos syntezatora mowy. Dodano element 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), na który ma zostać przetłumaczony.
close()	Usuwanie skojarzonych zasobów.
fromAuthorizationToken(string, string)	Statyczne wystąpienie funkcji 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 właściwość authorizationToken przy użyciu nowego prawidłowego tokenu. W przeciwnym razie wszystkie narzędzia rozpoznawania utworzone przez to wystąpienie usługi 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 utworzonych 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 korzystających z niestandardowego 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, można ustawić za pomocą innych interfejsów 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. Zakłada się, że zostanie założona standardowa ścieżka zasobu. W przypadku usług ze standardową ścieżką zasobu lub żadną ścieżką należy zamiast tego użyć polecenia fromEndpoint. Uwaga: parametry zapytania nie są dozwolone w identyfikatorze URI hosta i muszą być ustawione przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z elementem 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 w wersji 1.9.0.
fromSubscription(string, string)	Statyczne wystąpienie funkcji 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 (Przynieś własny magazyn (BYOS) z włączoną usługą Mowa. 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 rozpoznawania ciągłego 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. Tylko istotne w środowiskach Node.js. Dodano element w wersji 1.4.0.
setProxy(string, number, string, string)	Ustawia konfigurację serwera proxy. Tylko istotne 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. Zanim token autoryzacji wygaśnie, obiekt wywołujący musi go odświeżyć, wywołując ten setter z nowym prawidłowym tokenem.

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 wyjściowy 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 element 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 element w wersji 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Wartość właściwości

SpeechSynthesisOutputFormat

Zwraca format danych wyjściowych syntezy mowy

speechSynthesisVoiceName

Pobiera głos syntezatora mowy. Dodano element 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), na który ma zostać przetłumaczony.

function addTargetLanguage(value: string)

Parametry

value

string

Język, taki jak de-DE

close()

Usuwanie skojarzonych zasobów.

function close()

fromAuthorizationToken(string, string)

Statyczne wystąpienie funkcji 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 właściwość authorizationToken przy użyciu nowego prawidłowego tokenu. W przeciwnym razie wszystkie narzędzia rozpoznawania utworzone przez to wystąpienie usługi 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 utworzonych 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ę regionu ).

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 korzystających z niestandardowego 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, można ustawić za pomocą innych interfejsów 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. Zakłada się, że zostanie założona standardowa ścieżka zasobu. W przypadku usług ze standardową ścieżką zasobu lub żadną ścieżką należy zamiast tego użyć polecenia fromEndpoint. Uwaga: parametry zapytania nie są dozwolone w identyfikatorze URI hosta i muszą być ustawione przez inne interfejsy API. Uwaga: Aby użyć tokenu autoryzacji z elementem 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 w wersji 1.9.0.

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

Parametry

hostName

URL

subscriptionKey

string

Klucz subskrypcji. Jeśli nie określono klucza subskrypcji, należy ustawić token autoryzacji.

Zwraca

SpeechConfig

Wystąpienie fabryki mowy.

fromSubscription(string, string)

Statyczne wystąpienie funkcji 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ę regionu ).

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 (Przynieś własny magazyn (BYOS) z włączoną usługą Mowa. Dzienniki zostaną usunięte po upływie 30 dni. Dodano element w wersji 1.7.0.

function enableAudioLogging()

dziedziczone zSpeechConfig.enableAudioLogging

enableDictation()

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

function enableDictation()

dziedziczone zSpeechConfig.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, która ma być wysyłana do zapytania.

def

string

Wartość 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 zSpeechConfig.getProperty

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

dziedziczone zSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Parametry

profanity

ProfanityOption

dziedziczone zSpeechConfig.setProfanity

setProxy(string, number)

Ustawia konfigurację serwera proxy. Tylko istotne 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 zSpeechConfig.setProxy

setProxy(string, number, string, string)

Ustawia konfigurację serwera proxy. Tylko istotne 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 zSpeechConfig.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