Dela via

klass SpeechConfig

  • Artikel

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

Medlemmar

EmbeddedSpeechConfig

Syntax: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntax: public friend HybridSpeechConfig;

operatorN SPXSPEECHCONFIGHANDLE

Syntax: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

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

Återlämning

Ett handtag.

SetSpeechRecognitionLanguage

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

Ange indataspråket till taligenkänningen.

Parameterar

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

GetSpeechRecognitionLanguage

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

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

Återlämning

Taligenkänningsspråket.

SetSpeechSynthesisLanguage

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

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

Parameterar

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

GetSpeechSynthesisLanguage

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

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

Återlämning

Talsyntesspråket.

SetSpeechSynthesisVoiceName

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

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

Parameterar

  • voiceName Anger namnet på rösten

GetSpeechSynthesisVoiceName

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

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

Återlämning

Talsyntesens röstnamn.

SetSpeechSynthesisOutputFormat

Syntax: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

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

Parameterar

  • formatId Anger utdataformatets ID

GetSpeechSynthesisOutputFormat

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

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

Återlämning

Talsyntesens utdataformat.

SetEndpointId

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

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

Parameterar

  • endpointId slutpunkts-ID.

GetEndpointId

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

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

Återlämning

Slutpunkts-ID.

SetAuthorizationToken

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.

Parameterar

  • token Auktoriseringstoken.

GetAuthorizationToken

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

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

Återlämning

Auktoriseringstoken.

GetSubscriptionKey

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.

Återlämning

Prenumerationsnyckeln.

GetRegion

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.

Återlämning

Region.

GetOutputFormat

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.

Återlämning

Utdataformat för taligenkänning.

SetOutputFormat

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.

Parameterar

  • utdataformat för format taligenkänning

SetProfanity

Syntax: public inline void SetProfanity ( ProfanityOption profanity );

Anger svordomsalternativet. Har lagts till i version 1.5.0.

Parameterar

  • profanity svordomsalternativvärde.

EnableAudioLogging

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

RequestWordLevelTimestamps

Syntax: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

Syntax: public inline void EnableDictation ( );

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

SetProxy

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.

Parameterar

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

  • proxyPort Proxyserverns portnummer

  • proxyUserName Användarnamnet för proxyservern

  • proxyPassword Lösenordet för proxyservern

SetProperty

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

Anger ett egenskapsvärde efter namn.

Parameterar

  • name Egenskapsnamnet.

  • value Egenskapsvärdet.

GetProperty

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

Hämtar ett egenskapsvärde efter namn.

Parameterar

  • name Parameternamnet.

Återlämning

Egenskapsvärdet.

GetProperty

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

Hämtar ett egenskapsvärde efter ID.

Parameterar

  • id Parameter-ID.

Återlämning

Egenskapsvärdet.

SetProperty

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

Anger ett egenskapsvärde efter ID.

Parameterar

  • id Egenskaps-ID.

  • value Egenskapsvärdet.

SetServiceProperty

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.

Parameterar

  • name Egenskapsnamnet.

  • value Egenskapsvärdet.

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

~SpeechConfig

Syntax: public inline virtual ~SpeechConfig ( );

Förstör objektet.

FromSubscription

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.

Parameterar

  • subscription Prenumerationsnyckeln.

  • region Regionnamnet (se sidan region).

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.

FromAuthorizationToken

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.

Parameterar

  • authToken Auktoriseringstoken.

  • region Regionnamnet (se sidan region).

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.

FromEndpoint

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.

Parameterar

  • endpoint Tjänstslutpunkten att ansluta till.

  • subscription Prenumerationsnyckeln.

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.

FromEndpoint

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.

Parameterar

  • endpoint Tjänstslutpunkts-URI att ansluta till.

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.

FromHost

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.

Parameterar

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

  • subscription Prenumerationsnyckeln.

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.

FromHost

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.

Parameterar

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

Återlämning

En delad pekare till den nya talkonfigurationsinstansen.