SpeechConfig Klasse

Paket:

com.microsoft.cognitiveservices.speech

Maven-Artefakt:

com.microsoft.cognitiveservices.speech:client-sdk:1.32.1

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.SpeechConfig

Implementiert

java.lang.AutoCloseable

public class SpeechConfig
implements java.lang.AutoCloseable

Sprachkonfiguration. Hinweis: close() muss aufgerufen werden, um zugrunde liegende Ressourcen freizugeben, die sich im Besitz des -Objekts befinden. Geändert in Version 1.7.0

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
static java.lang.Class<?>	speechConfigClass Accessor zum Laden der nativen Bibliothek.

Zusammenfassung zum Konstruktor

Modifizierer	Konstruktor	Beschreibung
protected	SpeechConfig(long handleValue)	Interner Konstruktor für das Sprachkonfigurationsobjekt.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
void	close() Entsorgen Sie zugeordnete Ressourcen.
void	enableAudioLogging() Aktivieren Sie die Audioprotokollierung im Dienst.
void	enableDictation() Aktivieren Sie das Diktat.
static SpeechConfig	fromAuthorizationToken(String authorizationToken, String region) Erstellt eine instance einer Sprachkonfiguration mit dem angegebenen Autorisierungstoken und der angegebenen Dienstregion.
static SpeechConfig	fromEndpoint(URI endpoint) Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Endpunkt.
static SpeechConfig	fromEndpoint(URI endpoint, String subscriptionKey) Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Endpunkt und Abonnementschlüssel.
static SpeechConfig	fromHost(URI host) Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Host.
static SpeechConfig	fromHost(URI host, String subscriptionKey) Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Host- und Abonnementschlüssel.
static SpeechConfig	fromSubscription(String subscriptionKey, String region) Erstellt eine instance einer Sprachkonfiguration mit dem angegebenen Abonnementschlüssel und der angegebenen Dienstregion.
java.lang.String	getAuthorizationToken() Ruft das Autorisierungstoken ab.
java.lang.String	getEndpointId() Ruft die Endpunkt-ID eines benutzerdefinierten Sprachmodells ab, das für die Spracherkennung verwendet wird, oder eines benutzerdefinierten Sprachmodells für die Sprachsynthese.
SafeHandle	getImpl() Rufen Sie das native Handle für das Sprachkonfigurationsobjekt ab.
OutputFormat	getOutputFormat() Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert).
java.lang.String	getProperty(PropertyId id) Ruft die Eigenschaft nach Eigenschafts-IDab.
java.lang.String	getProperty(String name) Ruft eine benannte Eigenschaft als Wert ab.
java.lang.String	getSpeechRecognitionLanguage() Ruft die Sprache für die Spracherkennung ab.
java.lang.String	getSpeechSynthesisLanguage() Ruft die Sprache für die Sprachsynthese ab.
java.lang.String	getSpeechSynthesisOutputFormat() Ruft das Ausgabeformat der Sprachsynthese ab.
java.lang.String	getSpeechSynthesisVoiceName() Ruft den Sprachsynthese-Sprachnamen ab.
void	requestWordLevelTimestamps() Enthält Zeitstempel auf Wortebene.
void	setAuthorizationToken(String value) Legt das Autorisierungstoken fest.
void	setEndpointId(String value) Legt die Endpunkt-ID eines benutzerdefinierten Sprachmodells fest, das für die Spracherkennung verwendet wird, oder eines benutzerdefinierten Sprachmodells für die Sprachsynthese.
void	setOutputFormat(OutputFormat format) Legt das Ausgabeformat der Spracherkennung (einfach oder detailliert) fest.
void	setProfanity(ProfanityOption profanity) Legt die Option "Obszönität" fest.
void	setProperty(PropertyId id, String value) Legt die Eigenschaft nach Eigenschafts-IDfest.
void	setProperty(String name, String value) Legt eine benannte Eigenschaft als Wert fest.
void	setProxy(String proxyHostName, int proxyPort, String proxyUserName, String proxyPassword) Legt proxykonfiguration in Version 1.1.0 hinzugefügt fest.
void	setServiceProperty(String name, String value, ServicePropertyChannel channel) Legt einen Eigenschaftswert fest, der mithilfe des angegebenen Kanals an den Dienst übergeben wird.
void	setSpeechRecognitionLanguage(String value) Legt die Sprache der Spracherkennung fest
void	setSpeechSynthesisLanguage(String value) Legt die Sprache für die Sprachsynthese fest.
void	setSpeechSynthesisOutputFormat(SpeechSynthesisOutputFormat value) Legt das Ausgabeformat der Sprachsynthese fest.
void	setSpeechSynthesisVoiceName(String value) Legt den Namen der Sprachsynthese fest.

Geerbte Methoden von java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Felddetails

speechConfigClass

public static Class speechConfigClass

Accessor zum Laden der nativen Bibliothek. Hält die Klasse aktiv, sodass die Klasse GC sie nicht zurückerhält (und die lokalen Variablen!)

Details zum Konstruktor

SpeechConfig

protected SpeechConfig(long handleValue)

Interner Konstruktor für das Sprachkonfigurationsobjekt.

Parameters:

handleValue - Das native Handle.

Details zur Methode

close

public void close()

Entsorgen Sie zugeordnete Ressourcen.

enableAudioLogging

public void enableAudioLogging()

Aktivieren Sie die Audioprotokollierung im Dienst. Audio- und Inhaltsprotokolle werden entweder im Microsoft-eigenen Speicher oder in Ihrem eigenen Speicherkonto gespeichert, das mit Ihrem Cognitive Services-Abonnement (Bring Your Own Storage, BYOS) verknüpft ist. In Version 1.5.0 hinzugefügt.

enableDictation

public void enableDictation()

Aktivieren Sie das Diktat. Wird nur in der kontinuierlichen Spracherkennung unterstützt. In Version 1.5.0 hinzugefügt.

fromAuthorizationToken

public static SpeechConfig fromAuthorizationToken(String authorizationToken, String region)

Erstellt eine instance einer Sprachkonfiguration mit dem angegebenen Autorisierungstoken und der angegebenen Dienstregion. 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. Da Konfigurationswerte beim Erstellen einer neuen Erkennung kopiert werden, gilt der neue Tokenwert nicht für bereits erstellte Erkennungen. 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.

Parameters:

authorizationToken - Das Autorisierungstoken.

region - Der Regionsname (siehe Regionsseite).

Returns:

Eine Sprachkonfiguration instance.

fromEndpoint

public static SpeechConfig fromEndpoint(URI endpoint)

Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Endpunkt. Diese Methode ist nur für Benutzer gedacht, die einen nicht standardmäßigen Dienstendpunkt oder -parameter verwenden. Hinweis: Die im Endpunkt-URI angegebenen Abfrageparameter werden nicht geändert, auch wenn sie von anderen APIs festgelegt werden. Wenn die Erkennungssprache beispielsweise im URI als Abfrageparameter "language=de-DE" definiert und auch durch setSpeechRecognitionLanguage("en-US") festgelegt ist, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache lautet "de-DE". Nur die Parameter, die nicht im Endpunkt-URI angegeben sind, können von anderen APIs festgelegt werden. Hinweis: Wenn der Endpunkt einen Abonnementschlüssel für die Authentifizierung erfordert, verwenden Sie fromEndpoint(java.net.URI, String), um den Abonnementschlüssel als Parameter zu übergeben. Um ein Autorisierungstoken mit fromEndpoint zu verwenden, verwenden Sie diese Methode, um eine SpeechConfig-instance zu erstellen und dann setAuthorizationToken() für die erstellte SpeechConfig-instance aufzurufen. Hinweis: In Version 1.5.0 hinzugefügt.

Parameters:

endpoint - Der Dienstendpunkt, mit dem eine Verbindung hergestellt werden soll.

Returns:

Eine Sprachkonfiguration instance.

fromEndpoint

public static SpeechConfig fromEndpoint(URI endpoint, String subscriptionKey)

Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Endpunkt und Abonnementschlüssel. Diese Methode ist nur für Benutzer gedacht, die einen nicht standardmäßigen Dienstendpunkt oder -parameter verwenden. Hinweis: Die im Endpunkt-URI angegebenen Abfrageparameter werden nicht geändert, auch wenn sie von anderen APIs festgelegt werden. Wenn die Erkennungssprache beispielsweise im URI als Abfrageparameter "language=de-DE" definiert und auch durch setSpeechRecognitionLanguage("en-US") festgelegt ist, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache lautet "de-DE". Nur die Parameter, die nicht im Endpunkt-URI angegeben sind, können von anderen APIs festgelegt werden. Hinweis: Um ein Autorisierungstoken mit fromEndpoint zu verwenden, verwenden Sie fromEndpoint(java.net.URI), und rufen Sie dann setAuthorizationToken() für die erstellte SpeechConfig-instance auf.

Parameters:

endpoint - Der Dienstendpunkt, mit dem eine Verbindung hergestellt werden soll.

subscriptionKey - Der Abonnementschlüssel.

Returns:

Eine Sprachkonfiguration instance.

fromHost

public static SpeechConfig fromHost(URI host)

Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Host. Diese Methode ist nur für Benutzer gedacht, 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: Wenn der Host einen Abonnementschlüssel für die Authentifizierung erfordert, verwenden Sie fromHost(java.net.URI, String), um den Abonnementschlüssel als Parameter zu übergeben. Um ein Autorisierungstoken mit fromHost zu verwenden, verwenden Sie diese Methode, um eine SpeechConfig-instance zu erstellen, und rufen Sie dann setAuthorizationToken() für die erstellte SpeechConfig-instance auf. Hinweis: In Version 1.8.0 hinzugefügt.

Parameters:

host - Der Diensthost, mit dem eine Verbindung hergestellt werden soll. Das Format lautet "protocol://host:port", wobei ":p ort" optional ist.

Returns:

Eine Sprachkonfiguration instance.

fromHost

public static SpeechConfig fromHost(URI host, String subscriptionKey)

Erstellt eine instance der Sprachkonfiguration mit dem angegebenen Host- und Abonnementschlüssel. Diese Methode ist nur für Benutzer gedacht, 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(java.net.URI), und rufen Sie dann setAuthorizationToken() für die erstellte SpeechConfig-instance auf. Hinweis: In Version 1.8.0 hinzugefügt.

Parameters:

host - Der Diensthost, mit dem eine Verbindung hergestellt werden soll. Das Format lautet "protocol://host:port", wobei ":p ort" optional ist.

subscriptionKey - Der Abonnementschlüssel.

Returns:

Eine Sprachkonfiguration instance.

fromSubscription

public static SpeechConfig fromSubscription(String subscriptionKey, String region)

Erstellt eine instance einer Sprachkonfiguration mit dem angegebenen Abonnementschlüssel und der angegebenen Dienstregion.

Parameters:

subscriptionKey - Der Abonnementschlüssel.

region - Der Regionsname (siehe Regionsseite).

Returns:

Eine Sprachkonfiguration instance.

getAuthorizationToken

public String getAuthorizationToken()

Ruft das Autorisierungstoken ab.

Returns:

Das Autorisierungstoken.

getEndpointId

public String getEndpointId()

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

Returns:

Die Endpunkt-ID

getImpl

public SafeHandle getImpl()

Rufen Sie das native Handle für das Sprachkonfigurationsobjekt ab.

Returns:

Das native Handle.

getOutputFormat

public OutputFormat getOutputFormat()

Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert). Hinweis: Dieses Ausgabeformat ist für Spracherkennungsergebnisse vorgesehen. Verwenden Sie com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat zum Festlegen des synthetisierten Audioausgabeformats.

Returns:

Gibt das Ausgabeformat der Spracherkennung zurück.

getProperty

public String getProperty(PropertyId id)

Ruft die -Eigenschaft nach propertyId ab. In Version 1.3.0 hinzugefügt.

Parameters:

id - PropertyId der Eigenschaft.

Returns:

Der Wert.

getProperty

public String getProperty(String name)

Ruft eine benannte Eigenschaft als Wert ab.

Parameters:

name - der Name der Eigenschaft.

Returns:

Der Wert.

getSpeechRecognitionLanguage

public String getSpeechRecognitionLanguage()

Ruft die Sprache für die Spracherkennung ab.

Returns:

Gibt die Erkennungssprache zurück.

getSpeechSynthesisLanguage

public String getSpeechSynthesisLanguage()

Ruft die Sprache für die Sprachsynthese ab. In Version 1.7.0 hinzugefügt

Returns:

Gibt die Synthesesprache zurück.

getSpeechSynthesisOutputFormat

public String getSpeechSynthesisOutputFormat()

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

Returns:

Gibt das Ausgabeformat der Synthese zurück.

getSpeechSynthesisVoiceName

public String getSpeechSynthesisVoiceName()

Ruft den Sprachsynthese-Sprachnamen ab. In Version 1.7.0 hinzugefügt

Returns:

Gibt den Namen der Synthesestimme zurück.

requestWordLevelTimestamps

public void requestWordLevelTimestamps()

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

setAuthorizationToken

public void setAuthorizationToken(String value)

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. Da Konfigurationswerte beim Erstellen einer neuen Erkennung kopiert werden, gilt der neue Tokenwert nicht für bereits erstellte Erkennungen. 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.

Parameters:

value - das Autorisierungstoken.

setEndpointId

public void setEndpointId(String value)

Legt die Endpunkt-ID eines benutzerdefinierten Sprachmodells fest, das für die Spracherkennung verwendet wird, oder eines benutzerdefinierten Sprachmodells für die Sprachsynthese.

Parameters:

value - die Endpunkt-ID.

setOutputFormat

public void setOutputFormat(OutputFormat format)

Legt das Ausgabeformat der Spracherkennung (einfach oder detailliert) fest. Hinweis: Dieses Ausgabeformat dient für Spracherkennungsergebnisse. Verwenden Sie com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat zum Festlegen des synthetisierten Audioausgabeformats.

Parameters:

format - Das Ausgabeformat der Spracherkennung.

setProfanity

public void setProfanity(ProfanityOption profanity)

Legt die Option "Obszönität" fest. In Version 1.5.0 hinzugefügt.

Parameters:

profanity - die festzulegende Eigenschaftsoption.

setProperty

public void setProperty(PropertyId id, String value)

Legt die -Eigenschaft nach propertyId fest. In Version 1.3.0 hinzugefügt.

Parameters:

id - PropertyId der Eigenschaft.

value - Der Wert.

setProperty

public void setProperty(String name, String value)

Legt eine benannte Eigenschaft als Wert fest.

Parameters:

name - der Name der Eigenschaft.

value - den Wert.

setProxy

public void setProxy(String proxyHostName, int proxyPort, String proxyUserName, String proxyPassword)

Legt proxykonfiguration in Version 1.1.0 hinzugefügt fest. Hinweis: Proxyfunktionen sind unter macOS nicht verfügbar. Diese Funktion hat keine Auswirkungen auf diese Plattform.

Parameters:

proxyHostName - der Hostname des Proxyservers ohne Protokollschema (http://)

proxyPort - die Portnummer des Proxyservers.

proxyUserName - der Benutzername des Proxyservers. Verwenden Sie leere Zeichenfolge, wenn kein Benutzername erforderlich ist.

proxyPassword - das Kennwort des Proxyservers. Verwenden Sie leere Zeichenfolge, wenn kein Benutzerkennwort erforderlich ist.

setServiceProperty

public void setServiceProperty(String name, String value, ServicePropertyChannel channel)

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

Parameters:

name - der Eigenschaftsname.

value - der Eigenschaftswert.

channel - der Kanal, der verwendet wird, um die angegebene Eigenschaft an den Dienst zu übergeben.

setSpeechRecognitionLanguage

public void setSpeechRecognitionLanguage(String value)

Legt die Sprache der Spracherkennung fest

Parameters:

value - der Sprachbezeichner im BCP-47-Format.

setSpeechSynthesisLanguage

public void setSpeechSynthesisLanguage(String value)

Legt die Sprache für die Sprachsynthese fest. Hinzugefügt in Version 1.7.0

Parameters:

value - der Sprachbezeichner im BCP-47-Format (z. B. en-US).

setSpeechSynthesisOutputFormat

public void setSpeechSynthesisOutputFormat(SpeechSynthesisOutputFormat value)

Legt das Ausgabeformat der Sprachsynthese fest. Hinzugefügt in Version 1.7.0

Parameters:

value - Die ID des Syntheseausgabeformats (z. B. Riff16Khz16BitMonoPcm).

setSpeechSynthesisVoiceName

public void setSpeechSynthesisVoiceName(String value)

Legt den Namen der Sprachsynthese fest. Hinzugefügt in Version 1.7.0

Parameters:

value - Der Name der Sprachsynthesestimme.