Udostępnij za pośrednictwem

połączenie klasy

  • Artykuł
class Connection
  : public std::enable_shared_from_this< Connection >

Połączenie to klasa serwera proxy do zarządzania połączeniem z usługą rozpoznawania mowy określonego rozpoznawania. Domyślnie rozpoznawanie autonomiczne zarządza połączeniem z usługą w razie potrzeby. Klasa Połączenie udostępnia dodatkowe metody umożliwiające użytkownikom jawne otwieranie lub zamykanie połączenia oraz subskrybowanie zmian stanu połączenia. Użycie połączenia jest opcjonalne. Jest ona przeznaczona dla scenariuszy, w których potrzebne jest precyzyjne dostrajanie zachowania aplikacji na podstawie stanu połączenia. Użytkownicy mogą opcjonalnie wywołać metodę Open(), aby ręcznie zainicjować połączenie z usługą przed rozpoczęciem rozpoznawania w rozpoznawaniu skojarzonym z tym połączeniem. Po uruchomieniu rozpoznawania wywołanie metody Open() lub Close() może zakończyć się niepowodzeniem. Nie będzie to miało wpływu na rozpoznawanie ani trwającą rozpoznawanie. Połączenie może zostać porzucene z różnych powodów. Narzędzie rozpoznawania zawsze spróbuje przywrócić połączenie zgodnie z wymaganiami w celu zagwarantowania bieżących operacji. We wszystkich tych przypadkach zdarzenia Połączone/Rozłączone będą wskazywać zmianę stanu połączenia. Zaktualizowano w wersji 1.17.0.

Członkowie

Połączono

Składnia: public EventSignal< const ConnectionEventArgs & > Connected;

Zdarzenie Połączone wskazujące, że rozpoznawanie jest połączone z usługą.

Odłączony

Składnia: public EventSignal< const ConnectionEventArgs & > Disconnected;

Zdarzenie Rozłączone, aby wskazać, że rozpoznawanie jest odłączone od usługi.

MessageReceived

Składnia: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

Zdarzenie MessageReceived wskazujące, że podstawowy protokół odebrał komunikat z usługi. Dodano element w wersji 1.10.0.

Otwórz

Składnia: public inline void Open ( bool forContinuousRecognition );

Rozpoczyna konfigurowanie połączenia z usługą. Użytkownicy mogą opcjonalnie wywołać metodę Open(), aby ręcznie skonfigurować połączenie z wyprzedzeniem przed rozpoczęciem rozpoznawania/syntezy w narzędziu Recognizer/Syntetyzatorze skojarzonym z tym połączeniem. Po uruchomieniu rozpoznawania wywołanie metody Open() może zakończyć się niepowodzeniem w zależności od stanu procesu rozpoznawania/syntezatora. Jednak błąd nie ma wpływu na stan skojarzonego rozpoznawania/syntetyzatora. Uwaga: Po powrocie połączenie może nie być jeszcze gotowe. Zasubskrybuj zdarzenie Połączone, aby otrzymywać powiadomienia po nawiązaniu połączenia.

Parametry

  • forContinuousRecognition Wskazuje, czy połączenie jest używane do ciągłego rozpoznawania, czy rozpoznawania pojedynczego strzału. Nie ma żadnego wpływu, jeśli połączenie pochodzi z usługi SpeechSynthsizer.

Zamknij

Składnia: public inline void Close ( );

Zamyka połączenie z usługą. Użytkownicy mogą opcjonalnie wywołać metodę Close(), aby ręcznie zamknąć połączenie skojarzonego narzędzia Recognizer/Syntetyzator. Wywołanie może zakończyć się niepowodzeniem, w zależności od stanu procesu rozpoznawania/syntetyzatora. Jednak błąd nie ma wpływu na stan skojarzonego rozpoznawania/syntetyzatora.

SetMessageProperty

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

Dołącza parametr w komunikacie do usługi. Dodano element w wersji 1.7.0.

Parametry

  • path ścieżkę komunikatu.

  • propertyName Nazwa właściwości.

  • propertyValue wartość właściwości. Jest to ciąg json.

Zwraca

nieważny.

SendMessageAsync

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

Wyślij wiadomość do usługi mowy. Dodano element w wersji 1.7.0.

Parametry

  • path Ścieżka komunikatu.

  • payload Ładunek wiadomości. Jest to ciąg json.

Zwraca

Pusta przyszłość.

SendMessageAsync

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

Wyślij komunikat binarny do usługi rozpoznawania mowy. Ta metoda nie działa w przypadku połączenia interfejsu SpeechSynthesizer. Dodano element w wersji 1.10.0.

Parametry

  • path Ścieżka komunikatu.

  • payload Ładunek binarny komunikatu.

  • size Rozmiar ładunku binarnego.

Zwraca

Pusta przyszłość.

Połączenie

Składnia: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Konstruktor wewnętrzny. Tworzy nowe wystąpienie przy użyciu podanego dojścia.

Parametry

  • handle Dojście połączenia.

~Połączenie

Składnia: public inline ~Connection ( );

Destruktor.

FromRecognizer

Składnia: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Pobiera wystąpienie połączenia z określonego aparatu rozpoznawania.

Parametry

  • recognizer Rozpoznawanie skojarzone z połączeniem.

Zwraca

Wystąpienie połączenia rozpoznawania.

FromConversationTranslator

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

Pobiera wystąpienie połączenia z określonego tłumacza konwersacji.

Parametry

  • convTrans Translator konwersacji skojarzony z połączeniem.

Zwraca

Wystąpienie połączenia tłumacza konwersacji.

FromDialogServiceConnector

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

Pobiera wystąpienie połączenia z określonego łącznika usługi okna dialogowego, używane do obserwacji połączenia i zarządzania nim oraz rozłączenia z usługą rozpoznawania mowy.

Parametry

  • dialogServiceConnector Łącznik usługi okna dialogowego skojarzony z połączeniem.

Zwraca

Wystąpienie połączenia łącznika usługi dialogowej.

FromSpeechSynthesizer

Składnia: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Pobiera wystąpienie połączenia z określonego syntetyzatora mowy. Dodano element w wersji 1.17.0.

Parametry

  • synthesizer Syntetyzator mowy skojarzony z połączeniem.

Zwraca

Wystąpienie połączenia syntetyzatora mowy.