připojení třídy

  • Článek 
class Connection
  : public std::enable_shared_from_this< Connection >

Připojení je třída proxy pro správu připojení k řečové službě zadaného rozpoznávání. Rozpoznávání ve výchozím nastavení v případě potřeby samostatně spravuje připojení ke službě. Třída Connection poskytuje uživatelům další metody explicitně otevřít nebo zavřít připojení a přihlásit se k odběru změn stavu připojení. Připojení je volitelné. Je určená pro scénáře, kde je potřeba doladit chování aplikace na základě stavu připojení. Uživatelé můžou volitelně zavolat Open() a ručně zahájit připojení služby před zahájením rozpoznávání v rozpoznávání 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 probíhající rozpoznávání. Připojení může z různých důvodů vypadnout. Rozpoznávání se vždy pokusí znovu vytvořit připojení podle potřeby, aby se zajistily průběžné operace. Ve všech těchto případech události Připojeno/Odpojeno značí změnu stavu připojení. Aktualizováno ve verzi 1.17.0.

Členové

Připojeno

Syntaxe: public EventSignal< const ConnectionEventArgs & > Connected;

Událost Connected označuje, že je rozpoznávání připojeno ke službě.

Odpojeno

Syntaxe: public EventSignal< const ConnectionEventArgs & > Disconnected;

Událost Odpojeno má naznačovat, že je rozpoznávání odpojené od služby.

MessageReceived

Syntaxe: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

MessageReceived Událost označuje, že podkladový protokol přijal zprávu ze služby. Přidáno ve verzi 1.10.0.

Open

Syntaxe: public inline void Open ( bool forContinuousRecognition );

Spustí 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 na rozpoznávání/syntetizátoru přidruženém 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 recognizeru nebo syntetizátoru. Poznámka: Při vrácení nemusí být připojení ještě připravené. Přihlaste se k odběru připojené události, abyste byli upozorněni na navázání připojení.

Parametry

  • forContinuousRecognition Určuje, jestli se připojení používá k průběžnému rozpoznávání nebo k jednorázovému rozpoznávání. Pokud připojení pochází z speechSynthsizer, nemá to žádný vliv.

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 recognizeru/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 recognizeru 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ě. Tato metoda nefunguje pro připojení SpeechSynthesizer. Přidáno ve verzi 1.7.0.

Parametry

  • path cestu ke zprávě.

  • propertyName Název vlastnosti.

  • propertyValue Hodnota vlastnosti Toto je řetězec json.

Návraty

Void.

SendMessageAsync

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

Odeslání zprávy do služby Speech Tato metoda nefunguje pro připojení SpeechSynthesizer. Přidáno ve verzi 1.7.0.

Parametry

  • path Cesta ke zprávě.

  • payload Datová část zprávy. Toto je ř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 ke zprávě.

  • payload Binární datová čá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í zadané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á connection instance ze zadaného rozpoznávání.

Parametry

  • recognizer Rozpoznávání přidružené k připojení.

Návraty

Instance connection nástroje pro rozpoznávání.

FromConversationTranslator

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

Získá Connection instance ze zadaného překladače konverzace.

Parametry

  • convTrans Překladač konverzací přidružený k připojení.

Návraty

Instance Connection překladače konverzací.

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ého okna, 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.

Pochází zSpeechSynthesizer

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

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

Parametry

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

Návraty

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