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, jak explicitně otevřít nebo zavřít připojení a přihlásit se k odběru změn stavu připojení. Použití funkce Připojení je volitelné. Je určený pro scénáře, ve kterých je potřeba jemně doladit chování aplikace na základě stavu připojení. Uživatelé můžou volitelně volat Open(), aby ručně zahájili připojení ke službě před zahájením rozpoznávání na rozpoznávacím nástroji 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 z různých důvodů vypadnout. Rozpoznávání se vždy pokusí znovu vytvořit připojení podle potřeby, aby bylo zaručeno probíhající operace. Ve všech těchto případech události Připojeno/Odpojeno indikují změnu stavu připojení. Aktualizováno ve verzi 1.17.0.

Členové

Připojeno

Syntaxe: public EventSignal< constConnectionEventArgs & > Connected;

Událost Connected označující, že je rozpoznávatel připojen ke službě.

Odpojeno

Syntaxe: public EventSignal< constConnectionEventArgs & > Disconnected;

Událost Odpojeno, která označuje, že je rozpoznávatel odpojený od služby.

MessageReceived

Syntaxe: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

MessageReceived Událost označující, ž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 );

Začne nastavovat připojení ke službě. Uživatelé můžou volitelně volat Open(), aby předem ručně nastavili připojení před zahájením rozpoznávání nebo syntézy v rozpoznávání nebo syntezá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 syntezátoru. Selhání ale nemá vliv na stav přidruženého rozpoznávání nebo syntezátoru. Poznámka: Po návratu 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 Označuje, jestli se připojení používá k průběžnému rozpoznávání nebo k jednorázovému rozpoznávání. Pokud je připojení ze služby SpeechSynthsizer, nemá to žádný vliv.

Zavřít

Syntaxe: public inline void Close ( );

Zavře připojení ke službě. Uživatelé můžou volitelně volat Close() a ručně vypnout připojení přidruženého rozpoznávání/syntezátoru. Volání může selhat v závislosti na stavu procesu rozpoznávání nebo syntezátoru. Selhání ale nemá vliv na stav přidruženého rozpoznávání nebo syntezá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 );

Odešlete zprávu 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šlete 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í 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ávání.

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 Překladač konverzace přidružený k připojení.

Návraty

Instance Connection 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ého okna, který se používá pro sledování a správu 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á Connection instance ze zadaného syntetizátoru řeči. Přidáno ve verzi 1.17.0.

Parametry

  • synthesizer Syntetizátor řeči spojený s připojením.

Návraty

Instance Connection syntetizátoru řeči.