Delen via


klasse SpeechConfig

Klasse die configuraties definieert voor spraak-/intentieherkenning of spraaksynthese.

Leden

EmbeddedSpeechConfig

Syntaxis: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntaxis: public friend HybridSpeechConfig;

operator SPXSPEECHCONFIGHANDLE

Syntaxis: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Interne operator die wordt gebruikt om de onderliggende ingangswaarde op te halen.

Retouren

Een handvat.

SetSpeechRecognitionLanguage

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

Stel de invoertaal in op de spraakherkenning.

Parameterwaarden

  • lang Hiermee geeft u de naam van de gesproken taal die moet worden herkend in BCP-47-indeling.

GetSpeechRecognitionLanguage

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

Hiermee haalt u de invoertaal op voor de spraakherkenning. De taal wordt opgegeven in BCP-47-indeling.

Retouren

De taal voor spraakherkenning.

SetSpeechSynthesisLanguage

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

Hiermee stelt u de taal van de spraaksynthese in. Toegevoegd in versie 1.4.0.

Parameterwaarden

  • lang Geeft de naam van de taal (bijvoorbeeld en-US)

GetSpeechSynthesisLanguage

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

Haalt de taal van de spraaksynthese op. Toegevoegd in versie 1.4.0.

Retouren

De spraaksynthesetaal.

SetSpeechSynthesisVoiceName

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

Stel de stem van de spraaksynthese in. Toegevoegd in versie 1.4.0.

Parameterwaarden

  • voiceName Geeft de naam van de stem aan

GetSpeechSynthesisVoiceName

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

Krijgt de stem van de spraaksynthese. Toegevoegd in versie 1.4.0.

Retouren

De spraaksynthesenaam.

SetSpeechSynthesisOutputFormat

Syntaxis: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Hiermee stelt u de uitvoerindeling voor spraaksynthese in (bijvoorbeeld Riff16Khz16BitMonoPcm). Toegevoegd in versie 1.4.0.

Parameterwaarden

  • formatId Hiermee geeft u de id van de uitvoerindeling op

GetSpeechSynthesisOutputFormat

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

Hiermee haalt u de uitvoerindeling voor spraaksynthese op. Toegevoegd in versie 1.4.0.

Retouren

De uitvoerindeling voor spraaksynthese.

SetEndpointId

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

Hiermee stelt u de eindpunt-id van Custom Speech of Custom Voice in.

Parameterwaarden

  • endpointId eindpunt-id.

GetEndpointId

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

Hiermee haalt u de eindpunt-id van Custom Speech of Custom Voice op.

Retouren

Eindpunt-id.

SetAuthorizationToken

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

Hiermee stelt u het autorisatietoken in om verbinding te maken met de service. Opmerking: De aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door deze setter aan te roepen met een nieuw geldig token. Omdat configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de waarde van het nieuwe token niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende recognizer instellen om het token te vernieuwen. Anders treden de recognizers fouten op tijdens de herkenning.

Parameterwaarden

  • token het autorisatietoken.

GetAuthorizationToken

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

Hiermee haalt u het autorisatietoken op om verbinding te maken met de service.

Retouren

Het autorisatietoken.

GetSubscriptionKey

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

Hiermee haalt u de abonnementssleutel op die wordt gebruikt om Speech Recognizer of Intent Recognizer of Translation Recognizer of Speech Synthesizer te maken.

Retouren

De abonnementssleutel.

GetRegion

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

Hiermee haalt u de regiosleutel op die wordt gebruikt voor het maken van Speech Recognizer of Intent Recognizer of Translation Recognizer of speechSynth.

Retouren

Regio.

GetOutputFormat

Syntaxis: public inline OutputFormat GetOutputFormat ( ) const;

Hiermee haalt u de uitvoerindeling voor spraakherkenning op (eenvoudig of gedetailleerd). Opmerking: deze uitvoerindeling is bedoeld voor het resultaat van spraakherkenning. Gebruik SpeechConfig::GetSpeechSynthesisOutputFormat om een gesynthetiseerde audio-uitvoerindeling op te halen.

Retouren

Uitvoerindeling voor spraakherkenning.

SetOutputFormat

Syntaxis: public inline void SetOutputFormat ( OutputFormat format );

Hiermee stelt u de uitvoerindeling voor spraakherkenning in (eenvoudig of gedetailleerd). Opmerking: deze uitvoerindeling is bedoeld voor het resultaat van spraakherkenning. Gebruik SpeechConfig::SetSpeechSynthesisOutputFormat om een gesynthetiseerde audio-uitvoerindeling in te stellen.

Parameterwaarden

  • uitvoerindeling voor spraakherkenning format

SetProfanity

Syntaxis: public inline void SetProfanity ( ProfanityOption profanity );

Hiermee stelt u de optie grof taalgebruik in. Toegevoegd in versie 1.5.0.

Parameterwaarden

  • profanity waarde voor de optie Scheldbaarheid.

EnableAudioLogging

Syntaxis: public inline void EnableAudioLogging ( );

Hiermee schakelt u audiologboekregistratie in de service in. Toegevoegd in versie 1.5.0.

Audio- en inhoudslogboeken worden opgeslagen in opslag die eigendom is van Microsoft of in uw eigen opslagaccount dat is gekoppeld aan uw Cognitive Services-abonnement (Bring Your Own Storage (BYOS) waarvoor Spraakresource is ingeschakeld.

RequestWordLevelTimestamps

Syntaxis: public inline void RequestWordLevelTimestamps ( );

Bevat tijdstempels op woordniveau in antwoordresultaat. Toegevoegd in versie 1.5.0.

EnableDictation

Syntaxis: public inline void EnableDictation ( );

Hiermee schakelt u de dicteermodus in. Alleen ondersteund in spraak continue herkenning. Toegevoegd in versie 1.5.0.

SetProxy

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

Hiermee stelt u de proxyconfiguratie in die is toegevoegd in versie 1.1.0.

Opmerking: proxyfunctionaliteit is niet beschikbaar in macOS. Deze functie heeft geen effect op dit platform.

Parameterwaarden

  • proxyHostName De hostnaam van de proxyserver, zonder het protocolschema ([http://](http://))

  • proxyPort het poortnummer van de proxyserver

  • proxyUserName De gebruikersnaam van de proxyserver

  • proxyPassword het wachtwoord van de proxyserver

SetProperty

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

Hiermee stelt u een eigenschapswaarde op naam in.

Parameterwaarden

  • name de naam van de eigenschap.

  • value de waarde van de eigenschap.

GetProperty

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

Hiermee haalt u een eigenschapswaarde op naam op.

Parameterwaarden

  • name de parameternaam.

Retouren

De waarde van de eigenschap.

GetProperty

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

Hiermee haalt u een eigenschapswaarde op id op.

Parameterwaarden

  • id de parameter-id.

Retouren

De waarde van de eigenschap.

SetProperty

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

Hiermee stelt u een eigenschapswaarde in op id.

Parameterwaarden

  • id de eigenschaps-id.

  • value de waarde van de eigenschap.

SetServiceProperty

Syntaxis: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );

Hiermee stelt u een eigenschapswaarde in die wordt doorgegeven aan de service met behulp van het opgegeven kanaal. Toegevoegd in versie 1.5.0.

Parameterwaarden

  • name de naam van de eigenschap.

  • value de waarde van de eigenschap.

  • channel Het kanaal dat wordt gebruikt om de opgegeven eigenschap door te geven aan de service.

~SpeechConfig

Syntaxis: public inline virtual ~SpeechConfig ( );

Hiermee wordt het object gedestructeerd.

FromSubscription

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

Hiermee maakt u een exemplaar van de spraakconfiguratie met de opgegeven abonnementssleutel en regio.

Parameterwaarden

  • subscription de abonnementssleutel.

  • region De regionaam (zie de pagina regio).

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

FromAuthorizationToken

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

Hiermee maakt u een exemplaar van de spraakconfiguratie met het opgegeven autorisatietoken en de opgegeven regio. Opmerking: De aanroeper moet ervoor zorgen dat het autorisatietoken geldig is. Voordat het autorisatietoken verloopt, moet de aanroeper het vernieuwen door deze setter aan te roepen met een nieuw geldig token. Omdat configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de waarde van het nieuwe token niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende recognizer instellen om het token te vernieuwen. Anders treden de recognizers fouten op tijdens de herkenning.

Parameterwaarden

  • authToken het autorisatietoken.

  • region De regionaam (zie de pagina regio).

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

VanEndpoint

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

Hiermee maakt u een exemplaar van de spraakconfiguratie met het opgegeven eindpunt en abonnement. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservice-eindpunt gebruiken. Opmerking: de queryparameters die zijn opgegeven in de eindpunt-URI, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Als de herkenningstaal bijvoorbeeld is gedefinieerd in de URI als queryparameter "language=de-DE", en ook ingesteld door SetSpeechRecognitionLanguage("en-US"), heeft de taalinstelling in URI voorrang en de effectieve taal is "de-DE". Alleen de parameters die niet zijn opgegeven in de eindpunt-URI kunnen worden ingesteld door andere API's. Opmerking: Als u een autorisatietoken wilt gebruiken met FromEndpoint, gebruikt u FromEndpoint(const SPXSTRING&) en roept u SetAuthorizationToken() aan op het gemaakte SpeechConfig-exemplaar.

Parameterwaarden

  • endpoint Het service-eindpunt waarmee u verbinding wilt maken.

  • subscription de abonnementssleutel.

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

VanEndpoint

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

Hiermee maakt u een exemplaar van SpeechConfig met het opgegeven eindpunt. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservice-eindpunt gebruiken. Opmerking: de queryparameters die zijn opgegeven in de eindpunt-URI, worden niet gewijzigd, zelfs niet als ze zijn ingesteld door andere API's. Of een specifieke queryparameter wel of niet wordt ondersteund, is afhankelijk van het eindpunt en scenario. Als de herkenningstaal bijvoorbeeld is gedefinieerd in de URI als queryparameter "language=de-DE", en ook ingesteld door SetSpeechRecognitionLanguage("en-US"), heeft de taalinstelling in URI voorrang en de effectieve taal is "de-DE". Het voorbeeld is alleen van toepassing wanneer de combinatie van eindpunten en scenario's taal ondersteunt als queryparameter. Alleen de parameters die niet zijn opgegeven in de eindpunt-URI kunnen worden ingesteld door andere API's. Opmerking: als voor het eindpunt een abonnementssleutel is vereist voor verificatie, gebruikt u FromEndpoint(const SPXSTRING&, const SPXSTRING&) om de abonnementssleutel als parameter door te geven. Als u een autorisatietoken wilt gebruiken met FromEndpoint, gebruikt u deze methode om een SpeechConfig-exemplaar te maken en roept u SetAuthorizationToken() aan op het gemaakte SpeechConfig-exemplaar. Opmerking: Toegevoegd in versie 1.5.0.

Parameterwaarden

  • endpoint de URI van het service-eindpunt waarmee verbinding moet worden gemaakt.

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

FromHost

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

Hiermee maakt u een exemplaar van de spraakconfiguratie met de opgegeven host en het opgegeven abonnement. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservicehost gebruiken. Standaardresourcepad wordt ervan uitgegaan. Voor services met een niet-standaardresourcepad of helemaal geen pad, gebruikt u In plaats daarvan FromEndpoint. Opmerking: queryparameters zijn niet toegestaan in de host-URI en moeten worden ingesteld door andere API's. Opmerking: Als u een autorisatietoken wilt gebruiken met FromHost, gebruikt u FromHost(const SPXSTRING&) en roept u SetAuthorizationToken() aan op het gemaakte SpeechConfig-exemplaar. Opmerking: Toegevoegd in versie 1.8.0.

Parameterwaarden

  • host de servicehost waarmee u verbinding wilt maken. De indeling is protocol://host:port, waarbij ':p ort' optioneel is.

  • subscription de abonnementssleutel.

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

FromHost

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

Hiermee maakt u een exemplaar van SpeechConfig met de opgegeven host. Deze methode is alleen bedoeld voor gebruikers die een niet-standaardservicehost gebruiken. Standaardresourcepad wordt ervan uitgegaan. Voor services met een niet-standaardresourcepad of helemaal geen pad, gebruikt u In plaats daarvan FromEndpoint. Opmerking: queryparameters zijn niet toegestaan in de host-URI en moeten worden ingesteld door andere API's. Opmerking: Als voor de host een abonnementssleutel is vereist voor verificatie, gebruikt u FromHost(const SPXSTRING&, const SPXSTRING&) om de abonnementssleutel als parameter door te geven. Als u een autorisatietoken wilt gebruiken met FromHost, gebruikt u deze methode om een SpeechConfig-exemplaar te maken en roept u Vervolgens SetAuthorizationToken() aan op het gemaakte SpeechConfig-exemplaar. Opmerking: Toegevoegd in versie 1.8.0.

Parameterwaarden

  • host de URI van de servicehost waarmee verbinding moet worden gemaakt. De indeling is protocol://host:port, waarbij ':p ort' optioneel is.

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.