Připojení třídy

class Connection
  : public std::enable_shared_from_this< Connection >

Připojení je třída proxy pro správu připojení ke službě Speech zadaného rozpoznávání. Ve výchozím nastavení služba Recognizer v případě potřeby samostatně spravuje připojení ke službě. Třída Connection poskytuje uživatelům další metody, jak explicitně otevřít nebo zavřít připojení a přihlásit se k odběru změn stavu připojení. Použití připojení je volitelné. Je určen pro scénáře, kdy je potřeba jemně doladit chování aplikace na základě stavu připojení. Uživatelé můžou volitelně volat Open() a ručně zahájit připojení služby před spuštěním rozpoznávání v nástroji Recognizer přidruženém k tomuto připojení. Po spuštění rozpoznávání může volání Open() nebo Close() selhat. To nebude mít vliv na rozpoznávání ani na průběžné rozpoznávání. Připojení může dojít k poklesu z různých důvodů, služba Recognizer se vždy pokusí připojení obnovit podle potřeby, aby se zajistily probíhající operace. Ve všech těchto případech události Connected/Disconnected označují změnu stavu připojení. Aktualizováno ve verzi 1.17.0.

Členové

Připojený

Syntaxe: public EventSignal< const ConnectionEventArgs & > Connected;

Událost Connected (Připojeno) značí, že je rozpoznávání připojeno ke službě.

Nesouvislý

Syntaxe: public EventSignal< const ConnectionEventArgs & > Disconnected;

Odpojená událost označující, že je rozpoznávatel odpojen od služby.

MessageReceived

Syntaxe: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

Událost MessageReceived označující, že základní protokol obdržel zprávu ze služby. Přidáno ve verzi 1.10.0.

Otevřít

Syntaxe: public inline void Open ( bool forContinuousRecognition );

Spustí se nastavení připojení ke službě. Uživatelé můžou volitelně volat Open() a ručně nastavit připojení předem před zahájením rozpoznávání/syntézy u nástroje Recognizer/Syntetizátor přidružené k tomuto připojení. Po spuštění rozpoznávání může volání Open() selhat v závislosti na stavu procesu rozpoznávání nebo syntetizátoru. Selhání ale nemá vliv na stav přidruženého rozpoznávatele nebo syntetizátoru. Poznámka: Při návratu nemusí být připojení ještě připravené. Přihlaste se k odběru události Připojeno, abyste byli upozorněni při navázání připojení.

Parametry

• forContinuousRecognition Označuje, jestli se připojení používá k nepřetržitému rozpoznávání nebo k rozpoznávání jedním snímkem. Pokud je připojení z SpeechSynthsizer, nic se neprojeví.

Zavřít

Syntaxe: public inline void Close ( );

Ukončí připojení služby. Uživatelé můžou volitelně volat Close() a ručně vypnout připojení přidruženého rozpoznávání nebo syntetizátoru. Volání může selhat v závislosti na stavu procesu rozpoznávání nebo syntetizátoru. Selhání ale nemá vliv na stav přidruženého rozpoznávatele nebo syntetizátoru.

SetMessageProperty

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

Připojí parametr ve zprávě ke službě. Přidáno ve verzi 1.7.0.

Parametry

• path cestu ke zprávě.

• propertyName Název vlastnosti.

• propertyValue Hodnota vlastnosti. Jedná se o řetězec JSON.

Návraty

prázdnota.

SendMessageAsync

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

Odešlete zprávu do služby Speech. Přidáno ve verzi 1.7.0.

Parametry

• path Cesta zprávy.

• payload datovou část zprávy. Jedná se o řetězec JSON.

Návraty

Prázdná budoucnost.

SendMessageAsync

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

Odešle binární zprávu do služby Speech. Tato metoda nefunguje pro připojení SpeechSynthesizer. Přidáno ve verzi 1.10.0.

Parametry

• path Cesta zprávy.

• payload binární datovou část zprávy.

• size Velikost binární datové části.

Návraty

Prázdná budoucnost.

Připojení

Syntaxe: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Interní konstruktor. Vytvoří novou instanci pomocí poskytnutého popisovače.

Parametry

• handle popisovač připojení.

~Připojení

Syntaxe: public inline ~Connection ( );

Destruktor.

FromRecognizer

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

Získá instanci připojení ze zadaného rozpoznávatele.

Parametry

• recognizer Rozpoznávatel přidružený k připojení.

Návraty

Instance připojení rozpoznávatele.

FromConversationTranslator

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

Získá instanci připojení ze zadaného překladače konverzace.

Parametry

• convTrans Konverzační překladatel přidružený ke spojení.

Návraty

Instance připojení překladače konverzace.

FromDialogServiceConnector

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

Získá instanci připojení ze zadaného konektoru služby dialogových oken, který slouží k pozorování a správě připojení a odpojení od služby Speech.

Parametry

• dialogServiceConnector Konektor služby dialogového okna přidružený k připojení.

Návraty

Instance připojení konektoru služby dialogového okna.

FromSpeechSynthesizer

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

Získá instanci Connection ze zadaného syntetizátoru řeči. Přidáno ve verzi 1.17.0.

Parametry

• synthesizer Syntetizátor řeči přidružený k připojení.

Návraty

Instance připojení syntetizátoru řeči.