klass SpeechConfig

Klass som definierar konfigurationer för tal-/avsiktsigenkänning eller talsyntes.

Syntax: public friend EmbeddedSpeechConfig;

Syntax: public friend HybridSpeechConfig;

Syntax: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Intern operator som används för att hämta underliggande referensvärde.

Ett handtag.

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

Ange indataspråket till taligenkänningen.

• lang Anger namnet på talat språk som ska identifieras i BCP-47-format.

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

Hämtar indataspråket till taligenkänningen. Språket anges i BCP-47-format.

Taligenkänningsspråket.

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

Anger språket för talsyntesen. Har lagts till i version 1.4.0.

• lang Anger namnet på språket (t.ex. en-US)

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

Hämtar talsyntesens språk. Har lagts till i version 1.4.0.

Talsyntesspråket.

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

Ange talsyntesens röst. Har lagts till i version 1.4.0.

• voiceName Anger namnet på rösten

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

Hämtar talsyntesens röst. Har lagts till i version 1.4.0.

Talsyntesens röstnamn.

Syntax: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Anger talsyntesens utdataformat (t.ex. Riff16Khz16BitMonoPcm). Har lagts till i version 1.4.0.

• formatId Anger utdataformatets ID

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

Hämtar talsyntesens utdataformat. Har lagts till i version 1.4.0.

Talsyntesens utdataformat.

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

Anger slutpunkts-ID för anpassat tal eller anpassad röst.

• endpointId slutpunkts-ID.

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

Hämtar slutpunkts-ID för anpassat tal eller anpassad röst.

Slutpunkts-ID.

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

Anger auktoriseringstoken för att ansluta till tjänsten. Obs! Anroparen måste se till att auktoriseringstoken är giltig. Innan auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här settern med en ny giltig token. När konfigurationsvärden kopieras när du skapar en ny identifierare gäller inte det nya tokenvärdet för identifierare som redan har skapats. För identifierare som har skapats tidigare måste du ange auktoriseringstoken för motsvarande identifierare för att uppdatera token. Annars kommer identifierarna att stöta på fel under igenkänningen.

• token Auktoriseringstoken.

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

Hämtar auktoriseringstoken för att ansluta till tjänsten.

Auktoriseringstoken.

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

Hämtar prenumerationsnyckeln som används för att skapa taligenkänning eller avsiktsigenkänning eller översättningsigenkänning eller talsyntes.

Prenumerationsnyckeln.

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

Hämtar regionnyckeln som användes för att skapa taligenkänning eller avsiktsigenkänning eller översättningsigenkänning eller talsyntes.

Region.

Syntax: public inline OutputFormat GetOutputFormat ( ) const;

Hämtar utdataformat för taligenkänning (enkelt eller detaljerat). Obs! Det här utdataformatet är för taligenkänningsresultat, använd SpeechConfig::GetSpeechSynthesisOutputFormat för att få syntetiserat ljudutdataformat.

Utdataformat för taligenkänning.

Syntax: public inline void SetOutputFormat ( OutputFormat format );

Anger utdataformat för taligenkänning (enkelt eller detaljerat). Obs! Det här utdataformatet är för taligenkänningsresultat, använd SpeechConfig::SetSpeechSynthesisOutputFormat för att ange syntetiserat ljudutdataformat.

• utdataformat för format taligenkänning

Syntax: public inline void SetProfanity ( ProfanityOption profanity );

Anger svordomsalternativet. Har lagts till i version 1.5.0.

• profanity svordomsalternativvärde.

Syntax: public inline void EnableAudioLogging ( );

Aktiverar ljudloggning i tjänsten. Har lagts till i version 1.5.0.

Ljud- och innehållsloggar lagras antingen i Microsoft-ägd lagring eller i ditt eget lagringskonto som är länkat till din Cognitive Services-prenumeration (BYOS)-aktiverad Speech-resurs (Bring Your Own Storage).

Syntax: public inline void RequestWordLevelTimestamps ( );

Innehåller tidsstämplar på ordnivå i svarsresultatet. Har lagts till i version 1.5.0.

Syntax: public inline void EnableDictation ( );

Aktiverar dikteringsläge. Stöds endast vid kontinuerlig taligenkänning. Har lagts till i version 1.5.0.

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

Anger proxykonfiguration som lagts till i version 1.1.0.

Obs! Proxyfunktioner är inte tillgängliga i macOS. Den här funktionen påverkar inte den här plattformen.

• proxyHostName Proxyserverns värdnamn, utan protokollschemat ([http://](http://))

• proxyPort Proxyserverns portnummer

• proxyUserName Användarnamnet för proxyservern

• proxyPassword Lösenordet för proxyservern

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

Anger ett egenskapsvärde efter namn.

• name Egenskapsnamnet.

• value Egenskapsvärdet.

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

Hämtar ett egenskapsvärde efter namn.

• name Parameternamnet.

Egenskapsvärdet.

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

Hämtar ett egenskapsvärde efter ID.

• id Parameter-ID.

Egenskapsvärdet.

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

Anger ett egenskapsvärde efter ID.

• id Egenskaps-ID.

• value Egenskapsvärdet.

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

Anger ett egenskapsvärde som ska skickas till tjänsten med den angivna kanalen. Har lagts till i version 1.5.0.

• name Egenskapsnamnet.

• value Egenskapsvärdet.

• channel Kanalen som används för att skicka den angivna egenskapen till tjänsten.

Syntax: public inline virtual ~SpeechConfig ( );

Förstör objektet.

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

Skapar en instans av talkonfigurationen med angiven prenumerationsnyckel och region.

• subscription Prenumerationsnyckeln.

• region Regionnamnet (se sidan region).

En delad pekare till den nya talkonfigurationsinstansen.

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

Skapar en instans av talkonfigurationen med angiven auktoriseringstoken och region. Obs! Anroparen måste se till att auktoriseringstoken är giltig. Innan auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här settern med en ny giltig token. När konfigurationsvärden kopieras när du skapar en ny identifierare gäller inte det nya tokenvärdet för identifierare som redan har skapats. För identifierare som har skapats tidigare måste du ange auktoriseringstoken för motsvarande identifierare för att uppdatera token. Annars kommer identifierarna att stöta på fel under igenkänningen.

• authToken Auktoriseringstoken.

• region Regionnamnet (se sidan region).

En delad pekare till den nya talkonfigurationsinstansen.

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

Skapar en instans av talkonfigurationen med angiven slutpunkt och prenumeration. Den här metoden är endast avsedd för användare som använder en tjänstslutpunkt som inte är standard. Obs! Frågeparametrarna som anges i slutpunkts-URI:n ändras inte, även om de anges av andra API:er. Om till exempel igenkänningsspråket definieras i URI som frågeparametern "language=de-DE", och även anges av SetSpeechRecognitionLanguage("en-US"), har språkinställningen i URI företräde och det effektiva språket är "de-DE". Endast de parametrar som inte anges i slutpunkts-URI:n kan anges av andra API:er. Obs! Om du vill använda en auktoriseringstoken med FromEndpoint använder du FromEndpoint(const SPXSTRING&) och anropar sedan SetAuthorizationToken() på den skapade SpeechConfig-instansen.

• endpoint Tjänstslutpunkten att ansluta till.

• subscription Prenumerationsnyckeln.

En delad pekare till den nya talkonfigurationsinstansen.

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

Skapar en instans av SpeechConfig med angiven slutpunkt. Den här metoden är endast avsedd för användare som använder en tjänstslutpunkt som inte är standard. Obs! Frågeparametrarna som anges i slutpunkts-URI:n ändras inte, även om de anges av andra API:er. Om en specifik frågeparameter stöds eller inte beror på slutpunkten och scenariot. Om till exempel igenkänningsspråket definieras i URI som frågeparametern "language=de-DE", och även anges av SetSpeechRecognitionLanguage("en-US"), har språkinställningen i URI företräde och det effektiva språket är "de-DE". Exemplet gäller endast när kombinationen av slutpunkter och scenario stöder språk som en frågeparameter. Endast de parametrar som inte anges i slutpunkts-URI:n kan anges av andra API:er. Obs! Om slutpunkten kräver en prenumerationsnyckel för autentisering använder du FromEndpoint(const SPXSTRING&, const SPXSTRING&) för att skicka prenumerationsnyckeln som parameter. Om du vill använda en auktoriseringstoken med FromEndpoint använder du den här metoden för att skapa en SpeechConfig-instans och anropar sedan SetAuthorizationToken() på den skapade SpeechConfig-instansen. Obs! Har lagts till i version 1.5.0.

• endpoint Tjänstslutpunkts-URI att ansluta till.

En delad pekare till den nya talkonfigurationsinstansen.

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

Skapar en instans av talkonfigurationen med angiven värd och prenumeration. Den här metoden är endast avsedd för användare som använder en tjänstvärd som inte är standard. Standardresurssökvägen antas. För tjänster med en resurssökväg som inte är standard eller ingen sökväg alls använder du FromEndpoint i stället. Obs! Frågeparametrar tillåts inte i värd-URI:n och måste anges av andra API:er. Obs! Om du vill använda en auktoriseringstoken med FromHost använder du FromHost(const SPXSTRING&) och anropar sedan SetAuthorizationToken() på den skapade SpeechConfig-instansen. Obs! Har lagts till i version 1.8.0.

• host Tjänstvärden att ansluta till. Formatet är "protocol://host:port" där ":p ort" är valfritt.

• subscription Prenumerationsnyckeln.

En delad pekare till den nya talkonfigurationsinstansen.

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

Skapar en instans av SpeechConfig med angiven värd. Den här metoden är endast avsedd för användare som använder en tjänstvärd som inte är standard. Standardresurssökvägen antas. För tjänster med en resurssökväg som inte är standard eller ingen sökväg alls använder du FromEndpoint i stället. Obs! Frågeparametrar tillåts inte i värd-URI:n och måste anges av andra API:er. Obs! Om värden kräver en prenumerationsnyckel för autentisering använder du FromHost(const SPXSTRING&, const SPXSTRING&) för att skicka prenumerationsnyckeln som parameter. Om du vill använda en auktoriseringstoken med FromHost använder du den här metoden för att skapa en SpeechConfig-instans och anropar sedan SetAuthorizationToken() på den skapade SpeechConfig-instansen. Obs! Har lagts till i version 1.8.0.

• host Tjänstens värd-URI att ansluta till. Formatet är "protocol://host:port" där ":p ort" är valfritt.

En delad pekare till den nya talkonfigurationsinstansen.