SpeechTranslationConfig class

Paket:

microsoft-cognitiveservices-speech-sdk

Sprachübersetzungskonfiguration.

Extends

SpeechConfig

Eigenschaften

authorizationToken	Ruft ab/legt das Autorisierungstoken fest. Hinweis: Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss der Aufrufer es aktualisieren, indem er diesen Setter mit einem neuen gültigen Token aufruft.
endpointId	Ruft die Endpunkt-ID eines angepassten Sprachmodells ab, das für die Spracherkennung verwendet wird.
outputFormat	Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert). Hinweis: Dieses Ausgabeformat dient zum Spracherkennungsergebnis, verwenden Sie [SpeechConfig.speechSynthesisOutputFormat] zum Abrufen des synthetisierten Audioausgabeformats.
region
speechRecognitionLanguage	Ruft die Spracherkennungssprache ab/legt sie fest.
speechSynthesisLanguage	Ruft die Sprache des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt.
speechSynthesisOutputFormat	Ruft das Ausgabeformat der Sprachsynthese ab. In Version 1.11.0 hinzugefügt.
speechSynthesisVoiceName	Ruft die Stimme des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt.
subscriptionKey
targetLanguages	Ruft die (Text)-Zielsprache ab, in die übersetzt werden soll.
voiceName	Ruft den ausgewählten Sprachnamen ab.

Methoden

addTargetLanguage(string)	Fügen Sie eine (Text)-Zielsprache hinzu, in die übersetzt werden soll.
close()	Verwerfen von zugeordneten Ressourcen.
fromAuthorizationToken(string, string)	Statische Instanz von SpeechTranslationConfig, die durch Übergeben des Autorisierungstokens und der Dienstregion zurückgegeben wird. Hinweis: Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss der Aufrufer es aktualisieren, indem das Eigenschaftsautorisierungstoken mit einem neuen gültigen Token festgelegt wird. Andernfalls treten bei der Erkennung alle von dieser SpeechTranslationConfig-Instanz erstellten Erkennungsfehler auf. Wenn Konfigurationswerte beim Erstellen einer neuen Erkennung kopiert werden, gilt der neue Tokenwert nicht für Erkennungen, die bereits erstellt wurden. Für Erkennungen, die zuvor erstellt wurden, müssen Sie das Autorisierungstoken der entsprechenden Erkennung festlegen, um das Token zu aktualisieren. Andernfalls treten bei der Erkennung Fehler auf.
fromEndpoint(URL, string)	Erstellt eine Instanz der Sprachübersetzungskonfiguration mit angegebenem Endpunkt und Abonnementschlüssel. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Dienstendpunkt oder Paramters verwenden. Hinweis: Die in der Endpunkt-URL angegebenen Abfrageeigenschaften werden nicht geändert, auch wenn sie von anderen APIs festgelegt werden. Wenn die Sprache beispielsweise im URI als Abfrageparameter "language=de-DE" definiert ist und auch von der speechRecognitionLanguage-Eigenschaft festgelegt wird, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache lautet "de-DE". Nur die Eigenschaften, die in der Endpunkt-URL nicht angegeben sind, können von anderen APIs festgelegt werden. Hinweis: Um autorisierungstoken mit fromEndpoint zu verwenden, übergeben Sie eine leere Zeichenfolge an den subscriptionKey in der fromEndpoint-Methode, und legen Sie dann "authorizationToken="token" für die erstellte SpeechConfig-Instanz fest, um das Autorisierungstoken zu verwenden.
fromHost(URL, string)	Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Host- und Abonnementschlüssel. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Diensthost verwenden. Der Standardressourcenpfad wird angenommen. Verwenden Sie für Dienste mit einem nicht standardmäßigen Ressourcenpfad oder gar keinem Pfad stattdessen fromEndpoint. Hinweis: Abfrageparameter sind im Host-URI nicht zulässig und müssen von anderen APIs festgelegt werden. Hinweis: Um ein Autorisierungstoken mit fromHost zu verwenden, verwenden Sie fromHost(URL), und legen Sie dann die AuthorizationToken-Eigenschaft für die erstellte SpeechConfig-Instanz fest. Hinweis: In Version 1.9.0 hinzugefügt.
fromSubscription(string, string)	Statische Instanz von SpeechTranslationConfig, die zurückgegeben wird, indem ein Abonnementschlüssel und eine Dienstregion übergeben werden.
setProperty(string | PropertyId, string)	Legt eine benannte Eigenschaft als Wert fest.

Geerbte Methoden

enableAudioLogging()	Aktivieren sie die Audioprotokollierung im Dienst. Audio- und Inhaltsprotokolle werden entweder im eigenen Speicher oder in Ihrem eigenen Speicherkonto gespeichert, das mit Ihrem Cognitive Services-Abonnement verknüpft ist (Bring Your Own Storage (BYOS) aktivierte Sprachressource). Die Protokolle werden nach 30 Tagen entfernt. In Version 1.7.0 hinzugefügt.
enableDictation()	Diktieren aktivieren. Wird nur für die kontinuierliche Spracherkennung unterstützt. In Version 1.7.0 hinzugefügt.
getProperty(string, string)	Gibt den aktuellen Wert einer beliebigen Eigenschaft zurück.
requestWordLevelTimestamps()	Enthält Zeitstempel auf Wortebene. In Version 1.7.0 hinzugefügt.
setProfanity(ProfanityOption)	Legt die Profanitätsoption fest. In Version 1.7.0 hinzugefügt.
setProxy(string, number)	Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt.
setProxy(string, number, string, string)	Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt.
setServiceProperty(string, string, UriQueryParameter)	Legt einen Eigenschaftswert fest, der mithilfe des angegebenen Kanals an den Dienst übergeben wird. In Version 1.7.0 hinzugefügt.

Details zur Eigenschaft

authorizationToken

Ruft ab/legt das Autorisierungstoken fest. Hinweis: Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss der Aufrufer es aktualisieren, indem er diesen Setter mit einem neuen gültigen Token aufruft.

void authorizationToken

Eigenschaftswert

void

endpointId

Ruft die Endpunkt-ID eines angepassten Sprachmodells ab, das für die Spracherkennung verwendet wird.

string endpointId

Eigenschaftswert

string

Die Endpunkt-ID

outputFormat

Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert). Hinweis: Dieses Ausgabeformat dient zum Spracherkennungsergebnis, verwenden Sie [SpeechConfig.speechSynthesisOutputFormat] zum Abrufen des synthetisierten Audioausgabeformats.

OutputFormat outputFormat

Eigenschaftswert

OutputFormat

Gibt das Ausgabeformat zurück.

region

string region

Eigenschaftswert

string

Die Region, die für die Konfiguration festgelegt ist.

speechRecognitionLanguage

Ruft die Spracherkennungssprache ab/legt sie fest.

void speechRecognitionLanguage

Eigenschaftswert

void

speechSynthesisLanguage

Ruft die Sprache des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt.

string speechSynthesisLanguage

Eigenschaftswert

string

Gibt die Sprachsynthesesprache zurück.

speechSynthesisOutputFormat

Ruft das Ausgabeformat der Sprachsynthese ab. In Version 1.11.0 hinzugefügt.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Eigenschaftswert

SpeechSynthesisOutputFormat

Gibt das Ausgabeformat der Sprachsynthese zurück.

speechSynthesisVoiceName

Ruft die Stimme des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt.

string speechSynthesisVoiceName

Eigenschaftswert

string

Gibt die Sprachsynthesestimme zurück.

subscriptionKey

string subscriptionKey

Eigenschaftswert

string

Der für die Konfiguration festgelegte Abonnementschlüssel.

targetLanguages

Ruft die (Text)-Zielsprache ab, in die übersetzt werden soll.

string[] targetLanguages

Eigenschaftswert

string[]

voiceName

Ruft den ausgewählten Sprachnamen ab.

string voiceName

Eigenschaftswert

string

Der Sprachname.

Details zur Methode

addTargetLanguage(string)

Fügen Sie eine (Text)-Zielsprache hinzu, in die übersetzt werden soll.

function addTargetLanguage(value: string)

Parameter

value

string

Die Sprache wie de-DE

close()

Verwerfen von zugeordneten Ressourcen.

function close()

fromAuthorizationToken(string, string)

Statische Instanz von SpeechTranslationConfig, die durch Übergeben des Autorisierungstokens und der Dienstregion zurückgegeben wird. Hinweis: Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss der Aufrufer es aktualisieren, indem das Eigenschaftsautorisierungstoken mit einem neuen gültigen Token festgelegt wird. Andernfalls treten bei der Erkennung alle von dieser SpeechTranslationConfig-Instanz erstellten Erkennungsfehler auf. Wenn Konfigurationswerte beim Erstellen einer neuen Erkennung kopiert werden, gilt der neue Tokenwert nicht für Erkennungen, die bereits erstellt wurden. Für Erkennungen, die zuvor erstellt wurden, müssen Sie das Autorisierungstoken der entsprechenden Erkennung festlegen, um das Token zu aktualisieren. Andernfalls treten bei der Erkennung Fehler auf.

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

Parameter

authorizationToken

string

Das Autorisierungstoken.

region

string

Der Regionsname (siehe Bereichsseite).

Gibt zurück

SpeechTranslationConfig

Die Konfigurationskonfiguration für die Sprachübersetzung.

fromEndpoint(URL, string)

Erstellt eine Instanz der Sprachübersetzungskonfiguration mit angegebenem Endpunkt und Abonnementschlüssel. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Dienstendpunkt oder Paramters verwenden. Hinweis: Die in der Endpunkt-URL angegebenen Abfrageeigenschaften werden nicht geändert, auch wenn sie von anderen APIs festgelegt werden. Wenn die Sprache beispielsweise im URI als Abfrageparameter "language=de-DE" definiert ist und auch von der speechRecognitionLanguage-Eigenschaft festgelegt wird, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache lautet "de-DE". Nur die Eigenschaften, die in der Endpunkt-URL nicht angegeben sind, können von anderen APIs festgelegt werden. Hinweis: Um autorisierungstoken mit fromEndpoint zu verwenden, übergeben Sie eine leere Zeichenfolge an den subscriptionKey in der fromEndpoint-Methode, und legen Sie dann "authorizationToken="token" für die erstellte SpeechConfig-Instanz fest, um das Autorisierungstoken zu verwenden.

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

Parameter

endpoint

URL

Der Dienstendpunkt, mit dem eine Verbindung hergestellt werden soll.

subscriptionKey

string

Der Abonnementschlüssel.

Gibt zurück

SpeechTranslationConfig

Eine Sprachkonfigurationsinstanz.

fromHost(URL, string)

Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Host- und Abonnementschlüssel. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Diensthost verwenden. Der Standardressourcenpfad wird angenommen. Verwenden Sie für Dienste mit einem nicht standardmäßigen Ressourcenpfad oder gar keinem Pfad stattdessen fromEndpoint. Hinweis: Abfrageparameter sind im Host-URI nicht zulässig und müssen von anderen APIs festgelegt werden. Hinweis: Um ein Autorisierungstoken mit fromHost zu verwenden, verwenden Sie fromHost(URL), und legen Sie dann die AuthorizationToken-Eigenschaft für die erstellte SpeechConfig-Instanz fest. Hinweis: In Version 1.9.0 hinzugefügt.

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

Parameter

hostName

URL

subscriptionKey

string

Der Abonnementschlüssel. Wenn kein Abonnementschlüssel angegeben ist, muss ein Autorisierungstoken festgelegt werden.

Gibt zurück

SpeechConfig

Eine Instanz der Sprachfactory.

fromSubscription(string, string)

Statische Instanz von SpeechTranslationConfig, die zurückgegeben wird, indem ein Abonnementschlüssel und eine Dienstregion übergeben werden.

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

Parameter

subscriptionKey

string

Der Abonnementschlüssel.

region

string

Der Regionsname (siehe Bereichsseite).

Gibt zurück

SpeechTranslationConfig

Die Konfigurationskonfiguration für die Sprachübersetzung.

setProperty(string | PropertyId, string)

Legt eine benannte Eigenschaft als Wert fest.

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

Parameter

name

string | PropertyId

Der Name der festzulegenden Eigenschaft.

value

string

Der neue Wert der Eigenschaft.

Details zur geerbten Methode

enableAudioLogging()

Aktivieren sie die Audioprotokollierung im Dienst. Audio- und Inhaltsprotokolle werden entweder im eigenen Speicher oder in Ihrem eigenen Speicherkonto gespeichert, das mit Ihrem Cognitive Services-Abonnement verknüpft ist (Bring Your Own Storage (BYOS) aktivierte Sprachressource). Die Protokolle werden nach 30 Tagen entfernt. In Version 1.7.0 hinzugefügt.

function enableAudioLogging()

Geerbt vonSpeechConfig.enableAudioLogging-

enableDictation()

Diktieren aktivieren. Wird nur für die kontinuierliche Spracherkennung unterstützt. In Version 1.7.0 hinzugefügt.

function enableDictation()

Geerbt vonSpeechConfig.enableDictation

getProperty(string, string)

Gibt den aktuellen Wert einer beliebigen Eigenschaft zurück.

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

Parameter

name

string

Der Name der abzufragenden Eigenschaft.

def

string

Der wert, der zurückgegeben werden soll, falls die Eigenschaft nicht bekannt ist.

Gibt zurück

string

Der aktuelle Wert oder der angegebene Standardwert der angegebenen Eigenschaft.

Geerbt vonSpeechConfig.getProperty

requestWordLevelTimestamps()

Enthält Zeitstempel auf Wortebene. In Version 1.7.0 hinzugefügt.

function requestWordLevelTimestamps()

geerbt vonSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Legt die Profanitätsoption fest. In Version 1.7.0 hinzugefügt.

function setProfanity(profanity: ProfanityOption)

Parameter

profanity

ProfanityOption

Geerbt vonSpeechConfig.setProfanity-

setProxy(string, number)

Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt.

function setProxy(proxyHostName: string, proxyPort: number)

Parameter

proxyHostName

string

Der Hostname des Proxyservers.

proxyPort

number

Die Portnummer des Proxyservers.

Geerbt vonSpeechConfig.setProxy-

setProxy(string, number, string, string)

Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt.

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

Parameter

proxyHostName

string

Der Hostname des Proxyservers ohne das Protokollschema (http://)

proxyPort

number

Die Portnummer des Proxyservers.

proxyUserName

string

Der Benutzername des Proxyservers.

proxyPassword

string

Das Kennwort des Proxyservers.

Geerbt vonSpeechConfig.setProxy-

setServiceProperty(string, string, UriQueryParameter)

Legt einen Eigenschaftswert fest, der mithilfe des angegebenen Kanals an den Dienst übergeben wird. In Version 1.7.0 hinzugefügt.

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

Parameter

name

string

value

string

channel

UriQueryParameter

Geerbt vonSpeechConfig.setServiceProperty-