osztálykapcsolat

class Connection
  : public std::enable_shared_from_this< Connection >

A kapcsolat egy proxyosztály a megadott felismerő beszédszolgáltatásával való kapcsolat kezelésére. Alapértelmezés szerint a recognizer autonóm módon kezeli a szolgáltatáshoz való kapcsolatot, ha szükséges. A Kapcsolat osztály további módszereket biztosít a felhasználók számára a kapcsolat explicit megnyitásához vagy bezárásához, valamint a kapcsolat állapotváltozására való feliratkozáshoz. A Kapcsolat használata nem kötelező. Olyan helyzetekhez készült, ahol az alkalmazás viselkedésének finomhangolására van szükség a kapcsolat állapota alapján. A felhasználók igény szerint meghívhatják az Open() szolgáltatást, hogy manuálisan kezdeményezhessenek szolgáltatáskapcsolatot, mielőtt elkezdenék a felismerést a kapcsolathoz társított felismerőn. A felismerés indítása után előfordulhat, hogy az Open() vagy a Close() hívása sikertelen lesz. Ez nem befolyásolja a felismerőt vagy a folyamatban lévő felismerést. A kapcsolat több okból is megszakadhat, a felismerő mindig megpróbálja helyreállítani a kapcsolatot a folyamatos műveletek garantálása érdekében. Ezekben az esetekben a csatlakoztatott/leválasztott események a kapcsolat állapotának változását jelzik. Frissítve az 1.17.0-s verzióban.

Tagok

Csatlakoztatva

Szintaxis: public EventSignal< const ConnectionEventArgs & > Connected;

A csatlakoztatott esemény azt jelzi, hogy a felismerő csatlakoztatva van a szolgáltatáshoz.

Szétkapcsolva

Szintaxis: public EventSignal< const ConnectionEventArgs & > Disconnected;

A leválasztott esemény azt jelzi, hogy a felismerő le van választva a szolgáltatásról.

MessageReceived

Szintaxis: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

A MessageReceived esemény azt jelzi, hogy a mögöttes protokoll üzenetet kapott a szolgáltatástól. Hozzáadva az 1.10.0-s verzióhoz.

Nyitott

Szintaxis: public inline void Open ( bool forContinuousRecognition );

Megkezdi a szolgáltatáshoz való csatlakozás beállítását. A felhasználók igény szerint meghívhatják az Open()t, hogy manuálisan állítsa be a kapcsolatot előre, mielőtt elkezdenék a felismerést/szintézist a kapcsolathoz társított Felismerő/Szintetizátoron. A felismerés indítása után az Open() meghívása sikertelen lehet a Felismerő/Szintetizátor folyamatállapotától függően. A hiba azonban nem befolyásolja a társított Recognizer/Synthesizer állapotát. Megjegyzés: Visszatéréskor előfordulhat, hogy a kapcsolat még nem áll készen. Iratkozzon fel a csatlakoztatott eseményre, hogy értesítést kapjon a kapcsolat létrejöttéről.

Paraméterek

• forContinuousRecognition Azt jelzi, hogy a kapcsolat a folyamatos felismeréshez vagy az egylövetű felismeréshez van-e használva. Ez nem lép érvénybe, ha a kapcsolat a SpeechSynthsizertől származik.

Bezár

Szintaxis: public inline void Close ( );

Bezárja a kapcsolatot a szolgáltatással. A felhasználók igény szerint meghívhatják a Close() függvényt a társított Recognizer/Synthesizer kapcsolat manuális leállításához. A hívás sikertelen lehet a Felismerő/Szintetizátor folyamatállapotától függően. A hiba azonban nem befolyásolja a társított Recognizer/Synthesizer állapotát.

SetMessageProperty

Szintaxis: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Hozzáfűzi egy paramétert egy üzenetben a szolgáltatáshoz. Hozzáadva az 1.7.0-s verzióhoz.

Paraméterek

• path az üzenet elérési útját.

• propertyName tulajdonság neve.

• propertyValue tulajdonság értéke. Ez egy json-sztring.

Visszatérítések

semmis.

SendMessageAsync

Szintaxis: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Üzenet küldése a beszédszolgáltatásnak. Hozzáadva az 1.7.0-s verzióhoz.

Paraméterek

• path Az üzenet elérési útja.

• payload Az üzenet hasznos adatai. Ez egy json-sztring.

Visszatérítések

Üres jövő.

SendMessageAsync

Szintaxis: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Bináris üzenet küldése a beszédszolgáltatásnak. Ez a módszer nem működik a SpeechSynthesizer kapcsolatához. Hozzáadva az 1.10.0-s verzióhoz.

Paraméterek

• path Az üzenet elérési útja.

• payload Az üzenet bináris hasznos adatai.

• size A bináris hasznos adat mérete.

Visszatérítések

Üres jövő.

Kapcsolat

Szintaxis: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Belső konstruktor. Létrehoz egy új példányt a megadott leíró használatával.

Paraméterek

• handle A kapcsolati leíró.

~Kapcsolat

Szintaxis: public inline ~Connection ( );

Destruktor.

FromRecognizer

Szintaxis: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Lekéri a kapcsolatpéldányt a megadott felismerőtől.

Paraméterek

• recognizer A kapcsolathoz társított felismerő.

Visszatérítések

A felismerő kapcsolatpéldánya.

FromConversationTranslator

Szintaxis: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Lekéri a kapcsolatpéldányt a megadott beszélgetési fordítótól.

Paraméterek

• convTrans A kapcsolathoz társított beszélgetési fordító.

Visszatérítések

A beszélgetési fordító kapcsolatpéldánya.

FromDialogServiceConnector

Szintaxis: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Lekéri a kapcsolatpéldányt a megadott párbeszédpanel-szolgáltatás-összekötőből, amely a kapcsolat megfigyelésére és kezelésére, valamint a beszédszolgáltatás leválasztására szolgál.

Paraméterek

• dialogServiceConnector A kapcsolathoz társított párbeszédpanel-szolgáltatás-összekötő.

Visszatérítések

A párbeszédpanel-szolgáltatás összekötőjének kapcsolatpéldánya.

FromSpeechSynthesizer

Szintaxis: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Lekéri a kapcsolatpéldányt a megadott beszédszintetizátorból. Hozzáadva az 1.17.0-s verzióhoz.

Paraméterek

• synthesizer A kapcsolathoz társított beszédszintetizátor.

Visszatérítések

A beszédszintetizátor kapcsolatpéldánya.