klasse SpeechConfig

  • Artikel

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

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.

Parameters

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

GetSpeechRecognitionLanguage

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

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

Retouren

De taal voor spraakherkenning.

SetSpeechSynthesisLanguage

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

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

Parameters

  • lang Hiermee geeft u de naam van de taal (bijvoorbeeld en-US)

GetSpeechSynthesisLanguage

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

Hiermee haalt u de taal van de spraaksynthesizer 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 spraaksynthesizer in. Toegevoegd in versie 1.4.0.

Parameters

  • voiceName Hiermee geeft u de naam van de stem

GetSpeechSynthesisVoiceName

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

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

Retouren

De spraaknaam van de spraaksynthese.

SetSpeechSynthesisOutputFormat

Syntaxis: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

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

Parameters

  • formatId Hiermee geeft u de uitvoerindelings-id op

GetSpeechSynthesisOutputFormat

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

Hiermee haalt u de uitvoerindeling van de 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.

Parameters

  • 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. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende herkenning instellen om het token te vernieuwen. Anders zullen de recognizers fouten tegenkomen tijdens de herkenning.

Parameters

  • 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 voor het maken van Speech Recognizer of Intent Recognizer of Translation Recognizer of Speech Synthesizer.

Retouren

De abonnementssleutel.

GetRegion

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

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

Retouren

Regio.

GetOutputFormat

Syntaxis: public inline OutputFormat GetOutputFormat ( ) const;

Hiermee haalt u de uitvoerindeling voor spraakherkenning op (eenvoudig of gedetailleerd). Opmerking: deze uitvoerindeling is voor spraakherkenningsresultaten. Gebruik SpeechConfig::GetSpeechSynthesisOutputFormat om de 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 voor spraakherkenningsresultaat. Gebruik SpeechConfig::SetSpeechSynthesisOutputFormat om de gesynthetiseerde audio-uitvoerindeling in te stellen.

Parameters

  • format Uitvoerindeling voor spraakherkenning

SetProfanity

Syntaxis: public inline void SetProfanity ( ProfanityOption profanity );

Hiermee stelt u de optie scheldwoorden in. Toegevoegd in versie 1.5.0.

Parameters

  • profanity Waarde van scheldwoordoptie.

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 microsoft-opslag of in uw eigen opslagaccount dat is gekoppeld aan uw Cognitive Services-abonnement (Bring Your Own Storage (BYOS) ingeschakelde spraakresource).

RequestWordLevelTimestamps

Syntaxis: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

Syntaxis: public inline void EnableDictation ( );

Hiermee schakelt u de dicteermodus in. Alleen ondersteund in continue spraakherkenning. 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.

Parameters

  • 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 in op naam.

Parameters

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

Parameters

  • name De parameternaam.

Retouren

De waarde van de eigenschap.

GetProperty

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

Hiermee wordt een eigenschapswaarde opgehaald op basis van id.

Parameters

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

Parameters

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

Parameters

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

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.

Parameters

  • subscription De abonnementssleutel.

  • region De regionaam (zie de regiopagina).

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. Als configuratiewaarden worden gekopieerd bij het maken van een nieuwe recognizer, is de nieuwe tokenwaarde niet van toepassing op recognizers die al zijn gemaakt. Voor recognizers die eerder zijn gemaakt, moet u het autorisatietoken van de bijbehorende herkenning instellen om het token te vernieuwen. Anders zullen de recognizers fouten tegenkomen tijdens de herkenning.

Parameters

  • authToken Het autorisatietoken.

  • region De regionaam (zie de regiopagina).

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

FromEndpoint

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-standaard service-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 in de URI is gedefinieerd als queryparameter 'language=de-DE', en ook is ingesteld door SetSpeechRecognitionLanguage("en-US"), heeft de taalinstelling in de URI voorrang en is de effectieve taal '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.

Parameters

  • endpoint Het service-eindpunt waarmee verbinding moet worden gemaakt.

  • subscription De abonnementssleutel.

Retouren

Een gedeelde aanwijzer naar het nieuwe exemplaar van de spraakconfiguratie.

FromEndpoint

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-standaard service-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 wordt ondersteund of niet, is afhankelijk van het eindpunt en het scenario. Als de herkenningstaal bijvoorbeeld in de URI is gedefinieerd als queryparameter 'language=de-DE', en ook is ingesteld door SetSpeechRecognitionLanguage("en-US"), heeft de taalinstelling in de URI voorrang en is de effectieve taal 'de-DE'. Het voorbeeld is alleen van toepassing wanneer de combinatie van eindpunt en scenario taal als queryparameter ondersteunt. 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 door te geven als parameter. 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.

Parameters

  • endpoint De service-eindpunt-URI 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. Er wordt uitgegaan van het standaardresourcepad. Voor services met een niet-standaard resourcepad of helemaal geen pad, gebruikt u 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.

Parameters

  • 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. Er wordt uitgegaan van het standaardresourcepad. Voor services met een niet-standaard resourcepad of helemaal geen pad, gebruikt u FromEndpoint. Opmerking: Queryparameters zijn niet toegestaan in de host-URI en moeten worden ingesteld door andere API's. Opmerking: als de host een abonnementssleutel 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 SetAuthorizationToken() aan op het gemaakte SpeechConfig-exemplaar. Opmerking: toegevoegd in versie 1.8.0.

Parameters

  • host De servicehost-URI 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.