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.

Returer

Ett handtag.

SetSpeechRecognitionLanguage

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

Ange indataspråket till taligenkänningen.

Parametrar

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

Returer

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.

Parametrar

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

Returer

Talsyntesspråket.

SetSpeechSynthesisVoiceName

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

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

Parametrar

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

Returer

Talsyntesens röstnamn.

SetSpeechSynthesisOutputFormat

Syntax: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Anger utdataformatet för talsyntesen (t.ex. Riff16Khz16BitMonoPcm). Har lagts till i version 1.4.0.

Parametrar

  • formatId Anger utdataformatets ID

GetSpeechSynthesisOutputFormat

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

Hämtar utdataformatet för talsyntes. Har lagts till i version 1.4.0.

Returer

Talsyntesens utdataformat.

SetEndpointId

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

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

Parametrar

  • endpointId Slutpunkts-ID.

GetEndpointId

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

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

Returer

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 uppstår fel i igenkännarna under igenkänningen.

Parametrar

  • token Auktoriseringstoken.

GetAuthorizationToken

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

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

Returer

Auktoriseringstoken.

GetSubscriptionKey

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

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

Returer

Prenumerationsnyckeln.

GetRegion

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

Hämtar regionnyckeln som används för att skapa taligenkänning eller avsiktsigenkänning, översättningsigenkänning eller talsyntiserare.

Returer

Regionen.

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 hämta syntetiserat ljudutdataformat.

Returer

Utdataformat för taligenkänning.

SetOutputFormat

Syntax: public inline void SetOutputFormat ( OutputFormat format );

Anger utdataformatet 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.

Parametrar

  • format Utdataformat för taligenkänning

SetProfanity

Syntax: public inline void SetProfanity ( ProfanityOption profanity );

Anger alternativet för olämpligt språk. Har lagts till i version 1.5.0.

Parametrar

  • profanity Alternativvärde för olämpligt språk.

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 med 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 tillagd i version 1.1.0.

Obs! Proxyfunktioner är inte tillgängliga på macOS. Den här funktionen har ingen effekt på den här plattformen.

Parametrar

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

Parametrar

  • name Egenskapsnamnet.

  • value Egenskapsvärdet.

GetProperty

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

Hämtar ett egenskapsvärde efter namn.

Parametrar

  • name Parameternamnet.

Returer

Egenskapsvärdet.

GetProperty

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

Hämtar ett egenskapsvärde efter ID.

Parametrar

  • id Parameter-ID:t.

Returer

Egenskapsvärdet.

SetProperty

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

Anger ett egenskapsvärde efter ID.

Parametrar

  • id Egenskaps-ID: t.

  • 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 hjälp av den angivna kanalen. Har lagts till i version 1.5.0.

Parametrar

  • 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 ( );

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

Parametrar

  • subscription Prenumerationsnyckeln.

  • region Regionnamnet (se regionsidan).

Returer

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 inställningen 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.

Parametrar

  • authToken Auktoriseringstoken.

  • region Regionnamnet (se regionsidan).

Returer

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 igenkänningsspråket till exempel 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.

Parametrar

  • endpoint Tjänstslutpunkten som du vill ansluta till.

  • subscription Prenumerationsnyckeln.

Returer

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 igenkänningsspråket till exempel 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 slutpunkt 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.

Parametrar

  • endpoint Tjänstslutpunkts-URI:n att ansluta till.

Returer

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äg antas. För tjänster med en icke-standardresurssökväg 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.

Parametrar

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

  • subscription Prenumerationsnyckeln.

Returer

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äg antas. För tjänster med en icke-standardresurssökväg 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.

Parametrar

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

Returer

En delad pekare till den nya talkonfigurationsinstansen.