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 proxyserverproxyUserName
De gebruikersnaam van de proxyserverproxyPassword
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.