SpeechTranslationConfig class
Sprachübersetzungskonfiguration.
- Extends
Eigenschaften
| authorization |
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. |
| endpoint |
Ruft die Endpunkt-ID eines angepassten Sprachmodells ab, das für die Spracherkennung verwendet wird. |
| output |
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 | |
| speech |
Ruft die Spracherkennungssprache ab/legt sie fest. |
| speech |
Ruft die Sprache des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt. |
| speech |
Ruft das Ausgabeformat der Sprachsynthese ab. In Version 1.11.0 hinzugefügt. |
| speech |
Ruft die Stimme des Sprachsynthesizers ab. In Version 1.11.0 hinzugefügt. |
| subscription |
|
| target |
Ruft die (Text)-Zielsprache ab, in die übersetzt werden soll. |
| token |
Ruft die TokenCredential-Instanz ab, falls konfiguriert. Nur verfügbar, wenn die AAD-basierte Authentifizierung über TokenCredential verwendet wird. |
| voice |
Ruft den ausgewählten Sprachnamen ab. |
Methoden
| add |
Fügen Sie eine (Text)-Zielsprache hinzu, in die übersetzt werden soll. |
| close() | Verwerfen von zugeordneten Ressourcen. |
| from |
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. |
| from |
Erstellt eine Instanz einer Sprachübersetzungskonfiguration mit einem benutzerdefinierten Endpunkt und Anmeldeinformationen. Die im Endpunkt-URI angegebenen Abfrageparameter werden nicht geändert, auch wenn sie durch einen anderen API-Aufruf festgelegt werden. Wenn z. B. die Erkennungssprache im URI-Abfrageparameter als "language=de-DE" definiert ist und die Eigenschaft SpeechRecognitionLanguage auf "en-US" festgelegt ist, hat die im URI festgelegte Sprache Vorrang, und "de-DE" bleibt die erwartete Sprache. Da Parameter, die im Endpunkt-URI enthalten sind, Vorrang haben, können nur Parameter, die nicht im Endpunkt-URI angegeben sind, von anderen APIs festgelegt werden. Unterstützte Anmeldeinformationstypen:
|
| from |
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. |
| from |
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. |
| from |
Statische Instanz von SpeechTranslationConfig, die zurückgegeben wird, indem ein Abonnementschlüssel und eine Dienstregion übergeben werden. |
| set |
Legt eine benannte Eigenschaft als Wert fest. |
Geerbte Methoden
| enable |
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. |
| enable |
Aktivieren Sie das Diktat. Wird nur für die kontinuierliche Spracherkennung unterstützt. In Version 1.7.0 hinzugefügt. |
| get |
Gibt den aktuellen Wert einer beliebigen Eigenschaft zurück. |
| request |
Enthält Zeitstempel auf Wortebene. In Version 1.7.0 hinzugefügt. |
| set |
Legt die Profanitätsoption fest. In Version 1.7.0 hinzugefügt. |
| set |
Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt. |
| set |
Legt die Proxykonfiguration fest. Nur in Node.js Umgebungen relevant. In Version 1.4.0 hinzugefügt. |
| set |
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
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
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[]
tokenCredential
Ruft die TokenCredential-Instanz ab, falls konfiguriert. Nur verfügbar, wenn die AAD-basierte Authentifizierung über TokenCredential verwendet wird.
any tokenCredential
Eigenschaftswert
any
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 Name der Region (siehe Seite Region).
Gibt zurück
Die Konfigurationskonfiguration für die Sprachübersetzung.
fromEndpoint(URL, any)
Erstellt eine Instanz einer Sprachübersetzungskonfiguration mit einem benutzerdefinierten Endpunkt und Anmeldeinformationen. Die im Endpunkt-URI angegebenen Abfrageparameter werden nicht geändert, auch wenn sie durch einen anderen API-Aufruf festgelegt werden. Wenn z. B. die Erkennungssprache im URI-Abfrageparameter als "language=de-DE" definiert ist und die Eigenschaft SpeechRecognitionLanguage auf "en-US" festgelegt ist, hat die im URI festgelegte Sprache Vorrang, und "de-DE" bleibt die erwartete Sprache. Da Parameter, die im Endpunkt-URI enthalten sind, Vorrang haben, können nur Parameter, die nicht im Endpunkt-URI angegeben sind, von anderen APIs festgelegt werden. Unterstützte Anmeldeinformationstypen:
- KeyCredential: Für die schlüsselbasierte Authentifizierung der API.
- TokenCredential: Für die Azure AD-basierte Authentifizierung. 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, credential: any): SpeechTranslationConfig
Parameter
- endpoint
-
URL
Der Dienstendpunkt, mit dem eine Verbindung hergestellt werden soll.
- credential
-
any
Die Anmeldeinformationen, die für die Authentifizierung verwendet werden.
Gibt zurück
Eine Instanz der Sprachfactory.
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
Eine Konfigurationsinstanz für die Sprachübersetzung.
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): SpeechTranslationConfig
Parameter
- hostName
-
URL
- subscriptionKey
-
string
Der Abonnementschlüssel. Wenn kein Abonnementschlüssel angegeben ist, muss ein Autorisierungstoken festgelegt werden.
Gibt zurück
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 Name der Region (siehe Seite Region).
Gibt zurück
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()
Aktivieren Sie das Diktat. 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