Class SpeechConfig

Klasse, die Konfigurationen für Spracherkennung oder Sprachsynthese definiert.

Elemente

EmbeddedSpeechConfig

Syntax: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntax: public friend HybridSpeechConfig;

Operator SPXSPEECHCONFIGHANDLE

Syntax: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Interner Operator, der zum Abrufen eines zugrunde liegenden Handlewerts verwendet wird.

Rückgaben

Ein Handle.

SetSpeechRecognitionLanguage

Syntax: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );

Legen Sie die Eingabesprache auf die Spracherkennung fest.

Die Parameter

• lang Gibt den Namen der gesprochenen Sprache an, die im BCP-47-Format erkannt werden soll.

GetSpeechRecognitionLanguage

Syntax: public inline std::string GetSpeechRecognitionLanguage ( ) const;

Ruft die Eingabesprache für die Spracherkennung ab. Die Sprache wird im BCP-47-Format angegeben.

Rückgaben

Die Sprache für die Spracherkennung.

SetSpeechSynthesisLanguage

Syntax: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

Legt die Sprache des Sprachsynthesizers fest. In Version 1.4.0 hinzugefügt.

Die Parameter

• lang Gibt den Namen der Sprache an (z. B. en-US)

GetSpeechSynthesisLanguage

Syntax: public inline std::string GetSpeechSynthesisLanguage ( ) const;

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

Rückgaben

Die Sprachsynthesesprache.

SetSpeechSynthesisVoiceName

Syntax: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

Legen Sie die Stimme des Sprachsynthesizers fest. In Version 1.4.0 hinzugefügt.

Die Parameter

• voiceName Gibt den Namen der Stimme an.

GetSpeechSynthesisVoiceName

Syntax: public inline std::string GetSpeechSynthesisVoiceName ( ) const;

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

Rückgaben

Der Sprachsynthesename.

SetSpeechSynthesisOutputFormat

Syntax: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Legt das Ausgabeformat der Sprachsynthese fest (z. B. Riff16Khz16BitMonoPcm). In Version 1.4.0 hinzugefügt.

Die Parameter

• formatId Gibt die Ausgabeformat-ID an.

GetSpeechSynthesisOutputFormat

Syntax: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

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

Rückgaben

Das Ausgabeformat der Sprachsynthese.

SetEndpointId

Syntax: public inline void SetEndpointId ( const std::string & endpointId );

Legt die Endpunkt-ID von benutzerdefinierter Sprache oder benutzerdefinierter VoIP fest.

Die Parameter

• endpointId Endpunkt-ID.

GetEndpointId

Syntax: public inline std::string GetEndpointId ( ) const;

Ruft die Endpunkt-ID von benutzerdefinierter Sprache oder benutzerdefinierter VoIP ab.

Rückgaben

Endpunkt-ID.

SetAuthorizationToken

Syntax: public inline void SetAuthorizationToken ( const std::string & token );

Legt das Autorisierungstoken fest, um eine Verbindung mit dem Dienst herzustellen. 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. 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.

Die Parameter

• token Das Autorisierungstoken.

GetAuthorizationToken

Syntax: public inline std::string GetAuthorizationToken ( ) const;

Ruft das Autorisierungstoken zum Herstellen einer Verbindung mit dem Dienst ab.

Rückgaben

Das Autorisierungstoken.

GetSubscriptionKey

Syntax: public inline std::string GetSubscriptionKey ( ) const;

Erhält den Abonnementschlüssel, der zur Erstellung von Spracherkennung, Übersetzungserkennung oder Sprachsynthesizer verwendet wird.

Rückgaben

Der Abonnementschlüssel.

GetRegion

Syntax: public inline std::string GetRegion ( ) const;

Erhält den Regionsschlüssel, mit dem Spracherkennung, Übersetzungserkennung oder Sprachsynthesizer erstellt wurde.

Rückgaben

Region.

GibAusgabeformat

Syntax: public inline OutputFormat GetOutputFormat ( ) const;

Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert). Hinweis: Dieses Ausgabeformat dient zum Spracherkennungsergebnis, verwenden Sie SpeechConfig::GetSpeechSynthesisOutputFormat, um das synthetisierte Audioausgabeformat zu erhalten.

Rückgaben

Ausgabeformat der Spracherkennung.

SetzeAusgabeformat

Syntax: public inline void SetOutputFormat ( OutputFormat format );

Legt das Ausgabeformat für die Spracherkennung fest (einfach oder detailliert). Hinweis: Dieses Ausgabeformat dient zum Spracherkennungsergebnis, verwenden Sie SpeechConfig::SetSpeechSynthesisOutputFormat zum Festlegen des synthetisierten Audioausgabeformats.

Die Parameter

• format Ausgabeformat der Spracherkennung

SetProfanity

Syntax: public inline void SetProfanity ( ProfanityOption profanity );

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

Die Parameter

• profanity Profanitätsoptionswert.

EnableAudioLogging

Syntax: public inline void EnableAudioLogging ( );

Aktiviert die Audioprotokollierung im Dienst. In Version 1.5.0 hinzugefügt.

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).

RequestWordLevelTimestamps

Syntax: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

Syntax: public inline void EnableDictation ( );

Aktiviert den Diktiermodus. Wird nur für die kontinuierliche Spracherkennung unterstützt. In Version 1.5.0 hinzugefügt.

SetProxy

Syntax: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );

Legt die Proxykonfiguration fest, die in Version 1.1.0 hinzugefügt wurde.

Hinweis: Proxyfunktionen sind unter macOS nicht verfügbar. Diese Funktion wirkt sich nicht auf diese Plattform aus.

Die Parameter

• proxyHostName Hostname des Proxyservers ohne das Protokollschema ([http://](http://))

• proxyPort Die Portnummer des Proxyservers

• proxyUserName Der Benutzername des Proxyservers

• proxyPassword Das Kennwort des Proxyservers

SetProperty

Syntax: public inline void SetProperty ( const std::string & name , const std::string & value );

Legt einen Eigenschaftswert anhand des Namens fest.

Die Parameter

• name Der Eigenschaftenname.

• value Der Eigenschaftswert.

GetProperty

Syntax: public inline std::string GetProperty ( const std::string & name ) const;

Ruft einen Eigenschaftswert anhand des Namens ab.

Die Parameter

• name Der Parametername.

Rückgaben

Der Eigenschaftswert.

GetProperty

Syntax: public inline std::string GetProperty ( PropertyId id ) const;

Ruft einen Eigenschaftswert nach ID ab.

Die Parameter

• id Die Parameter-ID.

Rückgaben

Der Eigenschaftswert.

SetProperty

Syntax: public inline void SetProperty ( PropertyId id , const std::string & value );

Legt einen Eigenschaftswert nach ID fest.

Die Parameter

• id Die Eigenschafts-ID.

• value Der Eigenschaftswert.

SetServiceProperty

Syntax: public inline void SetServiceProperty ( const std::string & name , const std::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.

Die Parameter

• name Der Eigenschaftenname.

• value Der Eigenschaftswert.

• channel Der Kanal, der zum Übergeben der angegebenen Eigenschaft an den Dienst verwendet wird.

~SpeechConfig

Syntax: public inline virtual ~SpeechConfig ( );

Destruktiert das Objekt.

FromSubscription

Syntax: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );

Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Abonnementschlüssel und der angegebenen Region.

Die Parameter

• subscription Der Abonnementschlüssel.

• region Der Regionsname (siehe Bereichsseite).

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.

FromAuthorizationToken

Syntax: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Autorisierungstoken und der angegebenen Region. 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. 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.

Die Parameter

• authToken Das Autorisierungstoken.

• region Der Regionsname (siehe Bereichsseite).

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.

FromEndpoint

Syntax: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );

Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Endpunkt und Abonnement. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Dienstendpunkt 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 ist und auch von SetSpeechRecognitionLanguage("en-US") festgelegt wird, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache ist "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(const SPXSTRING&), und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-Instanz auf.

Die Parameter

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

• subscription Der Abonnementschlüssel.

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.

FromEndpoint

Syntax: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );

Erstellt eine Instanz von SpeechConfig mit dem angegebenen Endpunkt. Diese Methode ist nur für Benutzer vorgesehen, die einen nicht standardmäßigen Dienstendpunkt verwenden. Hinweis: Die im Endpunkt-URI angegebenen Abfrageparameter werden nicht geändert, auch wenn sie von anderen APIs festgelegt werden. Ob ein bestimmter Abfrageparameter unterstützt wird oder nicht, hängt vom Endpunkt und Szenario ab. Wenn die Erkennungssprache beispielsweise im URI als Abfrageparameter "language=de-DE" definiert ist und auch von SetSpeechRecognitionLanguage("en-US") festgelegt wird, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache ist "de-DE". Das Beispiel gilt nur, wenn die Endpunkt- und Szenariokombination Sprache als Abfrageparameter unterstützt. 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 benötigt, verwenden Sie FromEndpoint(const SPXSTRING&, const SPXSTRING&), um den Abonnementschlüssel als Parameter zu übergeben. Um ein Autorisierungstoken mit FromEndpoint zu verwenden, verwenden Sie diese Methode, um eine SpeechConfig-Instanz zu erstellen, und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-Instanz auf. Hinweis: In Version 1.5.0 hinzugefügt.

Die Parameter

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

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.

FromHost

Syntax: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );

Erstellt eine Instanz der Sprachkonfiguration mit dem angegebenen Host und Abonnement. 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 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(const SPXSTRING&), und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-Instanz auf. Hinweis: In Version 1.8.0 hinzugefügt.

Die Parameter

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

• subscription Der Abonnementschlüssel.

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.

FromHost

Syntax: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );

Erstellt eine Instanz von SpeechConfig mit angegebenem Host. 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 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 benötigt, verwenden Sie FromHost(const SPXSTRING&, const SPXSTRING&), um den Abonnementschlüssel als Parameter zu übergeben. Um ein Autorisierungstoken mit FromHost zu verwenden, verwenden Sie diese Methode, um eine SpeechConfig-Instanz zu erstellen, und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-Instanz auf. Hinweis: In Version 1.8.0 hinzugefügt.

Die Parameter

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

Rückgaben

Ein freigegebener Zeiger auf die neue Sprachkonfigurationsinstanz.