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 Connection udostępnia dodatkowe metody jawnego otwierania lub zamykania połączenia oraz subskrybowania zmian stanu połączenia. Użycie połączenia jest opcjonalne. Jest ona przeznaczona dla scenariuszy, w których wymagane 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 wpłynie to na rozpoznawanie ani trwające rozpoznawanie. Połączenie może upuścić z różnych powodów. Rozpoznawanie zawsze podejmie próbę przywrócenia połączenia 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.

Elementy członkowskie

Połączone

Składnia: public EventSignal< constConnectionEventArgs & > Connected;

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

Odłączony

Składnia: public EventSignal< constConnectionEventArgs & > Disconnected;

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

MessageReceived

Składnia: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

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

Open

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 programu 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. Ta metoda nie działa w przypadku połączenia z usługą SpeechSynthesizer. Dodano w wersji 1.7.0.

Parametry

  • path ścieżka komunikatu.

  • propertyName Nazwa właściwości.

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

Zwraca

Void.

SendMessageAsync

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

Wyślij wiadomość do usługi mowy. Ta metoda nie działa w przypadku połączenia z usługą SpeechSynthesizer. Dodano w wersji 1.7.0.

Parametry

  • path Ścieżka komunikatu.

  • payload Ładunek komunikatu. 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 mowy. Ta metoda nie działa w przypadku połączenia z usługą SpeechSynthesizer. Dodano 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 uchwytu.

Parametry

  • handle Uchwyt połączenia.

~Połączenia

Składnia: public inline ~Connection ( );

Destruktora.

FromRecognizer

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

Pobiera wystąpienie połączenia z określonego 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 translatora 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 odłączania od usługi mowy.

Parametry

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

Zwraca

Wystąpienie połączenia łącznika usługi okna dialogowego.

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 w wersji 1.17.0.

Parametry

  • synthesizer Syntetyzator mowy skojarzony z połączeniem.

Zwraca

Wystąpienie połączenia syntezatora mowy.