class SpeechConfig

  • Cikk

A beszéd-/ szándékfelismerési vagy beszédszintézis-konfigurációkat definiáló osztály.

Tagok

EmbeddedSpeechConfig

Szintaxis: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Szintaxis: public friend HybridSpeechConfig;

operátor SPXSPEECHCONFIGHANDLE

Szintaxis: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Belső operátor a mögöttes leíró értékének lekéréséhez használatos.

Válaszok

Egy fogópont.

SetSpeechRecognitionLanguage

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

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

Paraméterek

  • lang A BCP-47 formátumban felismerni kívánt 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.

Válaszok

A beszédfelismerés nyelve.

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 Megadja a nyelv nevét (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.

Válaszok

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.

Válaszok

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.

Válaszok

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égpont azonosítója.

GetEndpointId

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

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

Válaszok

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 gondoskodnia kell arról, 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 tokenérték 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ákat tapasztalnak a felismerés során.

Paraméterek

  • token Az engedélyezési jogkivonat.

GetAuthorizationToken

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

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

Válaszok

Az engedélyezési jogkivonat.

GetSubscriptionKey

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

Lekéri a Speech Recognizer, az Intent Recognizer, a Translation Recognizer vagy a Speech Synthesizer létrehozásához használt előfizetési kulcsot.

Válaszok

Az előfizetési kulcs.

GetRegion

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

Lekéri a Speech Recognizer, az Intent Recognizer, a Translation Recognizer vagy a Speech Synthesizer létrehozásához használt régiókulcsot.

Válaszok

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 beszédfelismerési eredményhez készült. Használja a SpeechConfig::GetSpeechSynthesisOutputFormat parancsot a szintetizált hangkimeneti formátum lekéréséhez.

Válaszok

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 beszédfelismerési eredményhez készült. Használja a SpeechConfig::SetSpeechSynthesisOutputFormat parancsot 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 profanitás beállítás beállítása. Hozzáadva az 1.5.0-s verzióhoz.

Paraméterek

  • profanity Káromkodási 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 tárolása a Microsoft tulajdonában lévő tárolóban vagy a Cognitive Services-előfizetéshez társított saját tárfiókban (BYOS) engedélyezett Speech-erőforrásban történik.

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

Proxykonfiguráció beállítása Hozzáadva az 1.1.0-s verzióban.

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;

Név alapján lekér egy tulajdonságértéket.

Paraméterek

  • name A paraméter neve.

Válaszok

A tulajdonság értéke.

GetProperty

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

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

Paraméterek

  • id A paraméter azonosítója.

Válaszok

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ág azonosítója.

  • 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, amelyet a megadott csatornával ad át 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ásnak való átadásához használt csatorna.

~SpeechConfig

Szintaxis: public inline virtual ~SpeechConfig ( );

Az objektumot elpusztítja.

FromSubscription

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

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

Paraméterek

  • subscription Az előfizetési kulcs.

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

Válaszok

Megosztott mutató az új beszédkonfigurálási 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álás egy példányát a megadott engedélyezési jogkivonattal és régióval. Megjegyzés: A hívónak gondoskodnia kell arról, 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 tokenérték 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ákat tapasztalnak a felismerés során.

Paraméterek

  • authToken Az engedélyezési jogkivonat.

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

Válaszok

Megosztott mutató az új beszédkonfigurálási 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álás 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" is beállítja), az URI nyelvbeállítása elsőbbséget élvez, és a tényleges nyelv a "de-DE". Más API-k csak a végponti URI-ban nem megadott paramétereket állíthatják be. Megjegyzés: Ha hitelesítési jogkivonatot szeretne használni a FromEndpointtal, használja a FromEndpoint(const SPXSTRING&) parancsot, 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 kulcs.

Válaszok

Egy megosztott mutató az új beszédkonfigurálási példányhoz.

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. Attól függ, 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" is beállítja), az URI nyelvbeállítása elsőbbséget élvez, és a tényleges nyelv a "de-DE". A példa csak akkor érvényes, ha a végpont és a forgatókönyv kombinációja lekérdezési paraméterként támogatja a nyelvet. Más API-k csak a végponti URI-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, használja a FromEndpoint(const SPXSTRING&, const SPXSTRING&) lehetőséget az előfizetési kulcs paraméterként való átadásához. Ha hitelesítési jogkivonatot szeretne használni a FromEndpointtal, 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.

Válaszok

Egy megosztott mutató az új beszédkonfigurálási példányhoz.

FromHost

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

Létrehozza a beszédkonfigurálás 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ásgazdát használnak. A rendszer standard 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 FromEndpoint parancsot. 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 hitelesítési jogkivonatot szeretne használni a FromHosttal, használja a FromHost(const SPXSTRING&) parancsot, 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 kulcs.

Válaszok

Egy megosztott mutató az új beszédkonfigurálási példányhoz.

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ásgazdát használnak. A rendszer standard 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 FromEndpoint parancsot. 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, a FromHost(const SPXSTRING&, const SPXSTRING&) használatával adja át az előfizetési kulcsot paraméterként. Ha 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ás gazdagépének URI-ja, amelyhez csatlakozni szeretne. A formátum "protocol://host:port", ahol a ":p ort" nem kötelező.

Válaszok

Egy megosztott mutató az új beszédkonfigurálási példányhoz.