Freigeben über

SpeechConfig-Klasse

  • Artikel

Klasse, die Konfigurationen für die Sprach-/Absichtserkennung oder Sprachsynthese definiert.

Member

EmbeddedSpeechConfig

Syntax: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntax: public friend HybridSpeechConfig;

Operator SPXSPEECHCONFIGHANDLE

Syntax: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Interner Operator, der zum Abrufen des zugrunde liegenden Handle-Werts verwendet wird.

Gibt zurück

Ein Handler.

SetSpeechRecognitionLanguage

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

Legen Sie die Eingabesprache auf die Spracherkennung fest.

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.

Gibt zurück

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.

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.

Gibt zurück

Die Sprache für die Sprachsynthese.

SetSpeechSynthesisVoiceName

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

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

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.

Gibt zurück

Der Name der Sprachsynthesestimme.

SetSpeechSynthesisOutputFormat

Syntax: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

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

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.

Gibt zurück

Das Ausgabeformat der Sprachsynthese.

SetEndpointId

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

Legt die Endpunkt-ID von Custom Speech oder Custom Voice fest.

Parameter

  • endpointId Endpunkt-ID.

GetEndpointId

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

Ruft die Endpunkt-ID von Custom Speech oder Custom Voice ab.

Gibt zurück

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

Parameter

  • token Das Autorisierungstoken.

GetAuthorizationToken

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

Ruft das Autorisierungstoken ab, um eine Verbindung mit dem Dienst herzustellen.

Gibt zurück

Das Autorisierungstoken.

GetSubscriptionKey

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

Ruft den Abonnementschlüssel ab, der zum Erstellen von Spracherkennung, Absichtserkennung, Übersetzungserkennung oder Sprachsynthesesynthese verwendet wird.

Gibt zurück

Der Abonnementschlüssel.

GetRegion

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

Ruft den Regionsschlüssel ab, der zum Erstellen von Spracherkennung, Absichtserkennung oder Übersetzungserkennung oder Sprachsynthesizer verwendet wird.

Gibt zurück

Region

GetOutputFormat

Syntax: public inline OutputFormat GetOutputFormat ( ) const;

Ruft das Ausgabeformat der Spracherkennung ab (einfach oder detailliert). Hinweis: Dieses Ausgabeformat dient dem Ergebnis der Spracherkennung. Verwenden Sie SpeechConfig::GetSpeechSynthesisOutputFormat , um ein synthetisiertes Audioausgabeformat abzurufen.

Gibt zurück

Ausgabeformat der Spracherkennung.

SetOutputFormat

Syntax: public inline void SetOutputFormat ( OutputFormat format );

Legt das Ausgabeformat der Spracherkennung (einfach oder detailliert) fest. Hinweis: Dieses Ausgabeformat ist für das Ergebnis der Spracherkennung vorgesehen. Verwenden Sie SpeechConfig::SetSpeechSynthesisOutputFormat , um das synthetisierte Audioausgabeformat festzulegen.

Parameter

  • format Ausgabeformat der Spracherkennung

SetProfanity

Syntax: public inline void SetProfanity ( ProfanityOption profanity );

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

Parameter

  • profanity Wert der Obszönitätsoption.

EnableAudioLogging

Syntax: public inline void EnableAudioLogging ( );

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

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.

RequestWordLevelTimestamps

Syntax: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

Syntax: public inline void EnableDictation ( );

Aktiviert den Diktiermodus. Wird nur in der kontinuierlichen 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 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.

Parameter

  • proxyHostName Der Hostname des Proxyservers ohne 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 nach Name fest.

Parameter

  • name Der Eigenschaftsname.

  • value Der Eigenschaftswert.

GetProperty

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

Ruft einen Eigenschaftswert nach Name ab.

Parameter

  • name Der Parametername.

Gibt zurück

Der Eigenschaftswert.

GetProperty

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

Ruft einen Eigenschaftswert nach ID ab.

Parameter

  • id Die Parameter-ID.

Gibt zurück

Der Eigenschaftswert.

SetProperty

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

Legt einen Eigenschaftswert nach ID fest.

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.

Parameter

  • name Der Eigenschaftsname.

  • value Der Eigenschaftswert.

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

~SpeechConfig

Syntax: public inline virtual ~SpeechConfig ( );

Zerstört das -Objekt.

FromSubscription

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

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

Parameter

  • subscription Der Abonnementschlüssel.

  • region Der Regionsname (siehe Regionsseite).

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.

FromAuthorizationToken

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

Erstellt eine instance 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. 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.

Parameter

  • authToken Das Autorisierungstoken.

  • region Der Regionsname (siehe Regionsseite).

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.

FromEndpoint

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

Erstellt eine instance der Sprachkonfiguration mit angegebenem 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 und auch von SetSpeechRecognitionLanguage("en-US") festgelegt ist, 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-instance auf.

Parameter

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

  • subscription Der Abonnementschlüssel.

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.

FromEndpoint

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

Erstellt eine instance 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 und auch von SetSpeechRecognitionLanguage("en-US") festgelegt ist, hat die Spracheinstellung in URI Vorrang, und die effektive Sprache ist "de-DE". Das Beispiel gilt nur, wenn die Kombination aus Endpunkt und Szenario 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 erfordert, 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-instance zu erstellen, und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-instance auf. Hinweis: In Version 1.5.0 hinzugefügt.

Parameter

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

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.

FromHost

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

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

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.

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.

FromHost

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

Erstellt eine instance von SpeechConfig mit dem angegebenen 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 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(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-instance zu erstellen, und rufen Sie dann SetAuthorizationToken() für die erstellte SpeechConfig-instance auf. Hinweis: In Version 1.8.0 hinzugefügt.

Parameter

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

Gibt zurück

Ein freigegebener Zeiger auf die neue Sprachkonfiguration instance.