osztály SpeechConfig

Egy osztály, amely a beszédfelismerés vagy beszédszintézis konfigurációit határozza meg.

Tagok

EmbeddedSpeechConfig

Szintaxis: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Szintaxis: public friend HybridSpeechConfig;

operátor SPXSPEECHCONFIGHANDLE

Szintaxis: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

A mögöttes leíró értékének lekéréséhez használt belső operátor.

Visszatérítések

Egy fogópont.

SetSpeechRecognitionLanguage

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

Állítsa be a bemeneti nyelvet a beszédfelismerőre.

Paraméterek

• lang A BCP-47 formátumban felismerendő beszélt nyelv nevét adja meg.

GetSpeechRecognitionLanguage

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

Lekéri a bemeneti nyelvet a beszédfelismeréshez. A nyelv BCP-47 formátumban van megadva.

Visszatérítések

A beszédfelismerő nyelv.

SetSpeechSynthesisLanguage

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

Beállítja a beszédszintetizátor nyelvét. Hozzáadva az 1.4.0-s verzióhoz.

Paraméterek

• lang A nyelv nevét adja meg (pl. en-US)

GetSpeechSynthesisLanguage

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

Lekéri a beszédszintetizátor nyelvét. Hozzáadva az 1.4.0-s verzióhoz.

Visszatérítések

A beszédszintézis nyelve.

SetSpeechSynthesisVoiceName

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

Állítsa be a beszédszintetizátor hangját. Hozzáadva az 1.4.0-s verzióhoz.

Paraméterek

• voiceName A hang nevét adja meg

GetSpeechSynthesisVoiceName

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

Lekéri a beszédszintetizátor hangját. Hozzáadva az 1.4.0-s verzióhoz.

Visszatérítések

A beszédszintézis hangneve.

SetSpeechSynthesisOutputFormat

Szintaxis: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Beállítja a beszédszintézis kimeneti formátumát (pl. Riff16Khz16BitMonoPcm). Hozzáadva az 1.4.0-s verzióhoz.

Paraméterek

• formatId A kimeneti formátum azonosítóját adja meg

GetSpeechSynthesisOutputFormat

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

Lekéri a beszédszintézis kimeneti formátumát. Hozzáadva az 1.4.0-s verzióhoz.

Visszatérítések

A beszédszintézis kimeneti formátuma.

SetEndpointId

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

Beállítja a Custom Speech vagy a Custom Voice végpontazonosítóját.

Paraméterek

• endpointId végpontazonosító.

GetEndpointId

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

Lekéri a Custom Speech vagy a Custom Voice végpontazonosítóját.

Visszatérítések

Végpont azonosítója.

SetAuthorizationToken

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

Beállítja az engedélyezési jogkivonatot a szolgáltatáshoz való csatlakozáshoz. Megjegyzés: A hívónak biztosítania kell, hogy az engedélyezési jogkivonat érvényes legyen. Az engedélyezési jogkivonat lejárata előtt a hívónak frissítenie kell azt úgy, hogy meghívja ezt a beállítót egy új érvényes jogkivonattal. Mivel a konfigurációs értékek másolása új felismerő létrehozásakor történik, az új jogkivonat értéke nem lesz érvényes a már létrehozott felismerőkre. A korábban létrehozott felismerők esetében be kell állítania a megfelelő felismerő engedélyezési jogkivonatát a jogkivonat frissítéséhez. Ellenkező esetben a felismerők hibákba ütköznek a felismerés során.

Paraméterek

• token az engedélyezési jogkivonatot.

GetAuthorizationToken

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

Lekéri a szolgáltatáshoz való csatlakozáshoz szükséges engedélyezési jogkivonatot.

Visszatérítések

Az engedélyezési jogkivonat.

GetSubscriptionKey

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

Megkapja az előfizetési kulcsot, amellyel létrehozza a Beszédfelismerőt, Fordításfelismerőt vagy Beszédszintetizátort.

Visszatérítések

Az előfizetési kulcs.

GetRegion

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

Megkapja azt a régiókulcsot, amellyel Speech Recognizer, Translation Recognizer vagy Speech Synthesizer létrehozták.

Visszatérítések

Régió.

GetOutputFormat

Szintaxis: public inline OutputFormat GetOutputFormat ( ) const;

Lekéri a beszédfelismerés kimeneti formátumát (egyszerű vagy részletes). Megjegyzés: Ez a kimeneti formátum a beszédfelismerési eredményekhez készült, használja SpeechConfig::GetSpeechSynthesisOutputFormat a szintetizált hangkimenet formátumának lekéréséhez.

Visszatérítések

Beszédfelismerés kimeneti formátuma.

SetOutputFormat

Szintaxis: public inline void SetOutputFormat ( OutputFormat format );

Beállítja a beszédfelismerés kimeneti formátumát (egyszerű vagy részletes). Megjegyzés: Ez a kimeneti formátum a beszédfelismerési eredményhez készült, használja SpeechConfig::SetSpeechSynthesisOutputFormat a szintetizált hangkimeneti formátum beállításához.

Paraméterek

• format Beszédfelismerés kimeneti formátuma

SetProfanity

Szintaxis: public inline void SetProfanity ( ProfanityOption profanity );

A trágárság beállítás beállítása. Hozzáadva az 1.5.0-s verzióhoz.

Paraméterek

• profanity Profanitás beállítás értéke.

EnableAudioLogging

Szintaxis: public inline void EnableAudioLogging ( );

Engedélyezi a hangnaplózást a szolgáltatásban. Hozzáadva az 1.5.0-s verzióhoz.

A hang- és tartalomnaplók a Microsoft tulajdonában lévő tárolóban vagy a Cognitive Services-előfizetéshez (BYOS) engedélyezett Speech-erőforráshoz társított saját tárfiókban vannak tárolva.

RequestWordLevelTimestamps

Szintaxis: public inline void RequestWordLevelTimestamps ( );

Szószintű időbélyegeket tartalmaz a válasz eredményében. Hozzáadva az 1.5.0-s verzióhoz.

EnableDictation

Szintaxis: public inline void EnableDictation ( );

Engedélyezi a diktálási módot. Csak a beszéd folyamatos felismerésében támogatott. Hozzáadva az 1.5.0-s verzióhoz.

SetProxy

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

Beállítja a proxykonfigurációt, amely az 1.1.0-s verzióban van hozzáadva.

Megjegyzés: A proxyfunkciók nem érhetők el macOS rendszeren. Ez a függvény nem lesz hatással erre a platformra.

Paraméterek

• proxyHostName A proxykiszolgáló állomásneve a protokollséma nélkül ([http://](http://))

• proxyPort A proxykiszolgáló portszáma

• proxyUserName A proxykiszolgáló felhasználóneve

• proxyPassword A proxykiszolgáló jelszava

SetProperty

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

Tulajdonságértéket állít be név szerint.

Paraméterek

• name A tulajdonság neve.

• value A tulajdonság értéke.

GetProperty

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

Tulajdonságértéket kap név szerint.

Paraméterek

• name a paraméter nevét.

Visszatérítések

A tulajdonság értéke.

GetProperty

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

Tulajdonságértéket kap azonosító szerint.

Paraméterek

• id paraméterazonosítót.

Visszatérítések

A tulajdonság értéke.

SetProperty

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

Tulajdonságértéket állít be azonosító szerint.

Paraméterek

• id A tulajdonságazonosító.

• value A tulajdonság értéke.

SetServiceProperty

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

Beállít egy tulajdonságértéket, amely a megadott csatornával lesz átadva a szolgáltatásnak. Hozzáadva az 1.5.0-s verzióhoz.

Paraméterek

• name A tulajdonság neve.

• value A tulajdonság értéke.

• channel A megadott tulajdonság szolgáltatásba való továbbításához használt csatorna.

~SpeechConfig

Szintaxis: public inline virtual ~SpeechConfig ( );

Megsemmisíti az objektumot.

FromSubscription

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

Létrehozza a beszédkonfiguráció egy példányát a megadott előfizetési kulccsal és régióval.

Paraméterek

• subscription az előfizetési kulcsot.

• region A régió neve (lásd a régiólapját).

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.

FromAuthorizationToken

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

Létrehozza a beszédkonfiguráció egy példányát a megadott engedélyezési jogkivonattal és régióval. Megjegyzés: A hívónak biztosítania kell, hogy az engedélyezési jogkivonat érvényes legyen. Az engedélyezési jogkivonat lejárata előtt a hívónak frissítenie kell azt úgy, hogy meghívja ezt a beállítót egy új érvényes jogkivonattal. Mivel a konfigurációs értékek másolása új felismerő létrehozásakor történik, az új jogkivonat értéke nem lesz érvényes a már létrehozott felismerőkre. A korábban létrehozott felismerők esetében be kell állítania a megfelelő felismerő engedélyezési jogkivonatát a jogkivonat frissítéséhez. Ellenkező esetben a felismerők hibákba ütköznek a felismerés során.

Paraméterek

• authToken az engedélyezési jogkivonatot.

• region A régió neve (lásd a régiólapját).

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.

FromEndpoint

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

Létrehozza a beszédkonfiguráció egy példányát a megadott végponttal és előfizetéssel. Ez a módszer csak olyan felhasználók számára készült, akik nem szabványos szolgáltatásvégpontot használnak. Megjegyzés: A végpont URI-jában megadott lekérdezési paraméterek nem változnak, még akkor sem, ha más API-k állítják be őket. Ha például a felismerési nyelv az URI-ban a "language=de-DE" lekérdezési paraméterként van definiálva, és a SetSpeechRecognitionLanguage("en-US" beállítással is be van állítva), akkor az URI nyelvi beállítása elsőbbséget élvez, a tényleges nyelv pedig "de-DE". Más API-k csak a végpont URI-jában nem megadott paramétereket állíthatják be. Megjegyzés: Ha a FromEndpointtal szeretne engedélyezési jogkivonatot használni, használja a FromEndpoint(const SPXSTRING&), majd hívja meg a SetAuthorizationToken() parancsot a létrehozott SpeechConfig-példányon.

Paraméterek

• endpoint A szolgáltatásvégpont, amelyhez csatlakozni szeretne.

• subscription az előfizetési kulcsot.

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.

FromEndpoint

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

Létrehozza a SpeechConfig egy példányát a megadott végponttal. Ez a módszer csak olyan felhasználók számára készült, akik nem szabványos szolgáltatásvégpontot használnak. Megjegyzés: A végpont URI-jában megadott lekérdezési paraméterek nem változnak, még akkor sem, ha más API-k állítják be őket. Az, hogy egy adott lekérdezési paraméter támogatott-e vagy sem, a végponttól és a forgatókönyvtől függ. Ha például a felismerési nyelv az URI-ban a "language=de-DE" lekérdezési paraméterként van definiálva, és a SetSpeechRecognitionLanguage("en-US" beállítással is be van állítva), akkor az URI nyelvi beállítása elsőbbséget élvez, a tényleges nyelv pedig "de-DE". A példa csak akkor érvényes, ha a végpont és a forgatókönyv kombinációja támogatja a nyelvet lekérdezési paraméterként. Más API-k csak a végpont URI-jában nem megadott paramétereket állíthatják be. Megjegyzés: Ha a végponthoz előfizetési kulcs szükséges a hitelesítéshez, a FromEndpoint(const SPXSTRING&, const SPXSTRING&) használatával adja át paraméterként az előfizetési kulcsot. Ha a FromEndpointtal szeretne engedélyezési jogkivonatot használni, ezzel a módszerrel hozzon létre egy SpeechConfig-példányt, majd hívja meg a SetAuthorizationToken() parancsot a létrehozott SpeechConfig-példányon. Megjegyzés: Az 1.5.0-s verzióban van hozzáadva.

Paraméterek

• endpoint A szolgáltatásvégpont URI-ja, amelyhez csatlakozni szeretne.

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.

FromHost

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

Létrehozza a beszédkonfiguráció egy példányát a megadott gazdagéppel és előfizetéssel. Ez a módszer csak olyan felhasználók számára készült, akik nem alapértelmezett szolgáltatás-gazdagépet használnak. A rendszer normál erőforrás-elérési utat feltételez. A nem szabványos erőforrás-elérési úttal rendelkező vagy egyáltalán nem elérési úttal rendelkező szolgáltatások esetében használja inkább a FromEndpointot. Megjegyzés: A lekérdezési paraméterek nem engedélyezettek a gazdagép URI-jában, és más API-knak kell beállítaniuk. Megjegyzés: Ha engedélyezési jogkivonatot szeretne használni a FromHosttal, használja a FromHost(const SPXSTRING&), majd hívja meg a SetAuthorizationToken() parancsot a létrehozott SpeechConfig-példányon. Megjegyzés: Az 1.8.0-s verzióban van hozzáadva.

Paraméterek

• host A szolgáltatás gazdagépe, amelyhez csatlakozni szeretne. A formátum "protocol://host:port", ahol a ":p ort" nem kötelező.

• subscription az előfizetési kulcsot.

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.

FromHost

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

Létrehozza a SpeechConfig egy példányát a megadott gazdagéppel. Ez a módszer csak olyan felhasználók számára készült, akik nem alapértelmezett szolgáltatás-gazdagépet használnak. A rendszer normál erőforrás-elérési utat feltételez. A nem szabványos erőforrás-elérési úttal rendelkező vagy egyáltalán nem elérési úttal rendelkező szolgáltatások esetében használja inkább a FromEndpointot. Megjegyzés: A lekérdezési paraméterek nem engedélyezettek a gazdagép URI-jában, és más API-knak kell beállítaniuk. Megjegyzés: Ha a gazdagépnek előfizetési kulcsra van szüksége a hitelesítéshez, használja a FromHost(const SPXSTRING&, const SPXSTRING&) lehetőséget az előfizetési kulcs paraméterként való átadásához. Ha egy hitelesítési jogkivonatot szeretne használni a FromHosttal, ezzel a módszerrel hozzon létre egy SpeechConfig-példányt, majd hívja meg a SetAuthorizationToken() parancsot a létrehozott SpeechConfig-példányon. Megjegyzés: Az 1.8.0-s verzióban van hozzáadva.

Paraméterek

• host A szolgáltatásgazda URI-ja, amelyhez csatlakozni szeretne. A formátum "protocol://host:port", ahol a ":p ort" nem kötelező.

Visszatérítések

Egy megosztott mutató az új beszédkonfigurációs példányra.