Udostępnij za pośrednictwem

okno dialogowe klasy::D ialogServiceConnector

  • Artykuł
class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

Obiekt używany do łączenia funkcji DirectLineSpeech lub CustomCommands.

Obiekty tego typu są tworzone za pośrednictwem metody FromConfig Factory.

Elementy członkowskie

Rozpoznawane

Składnia: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

Sygnał dla zdarzeń zawierających wyniki rozpoznawania mowy.

Uznając

Składnia: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

Sygnał dla zdarzeń zawierających wyniki rozpoznawania pośredniego.

SesjaStarted

Składnia: public EventSignal< constSessionEventArgs & > SessionStarted;

Sygnały wskazujące początek sesji nasłuchiwania.

SessionStopped

Składnia: public EventSignal< constSessionEventArgs & > SessionStopped;

Sygnał wskazujący koniec sesji nasłuchiwania.

SpeechStartDetected

Składnia: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

Sygnał wskazujący pierwsze wykrywanie danych mowy w bieżącej frazie.

SpeechEndDetected

Składnia: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

Sygnał wskazujący wykryty koniec danych mowy bieżącej frazy.

Anulowane

Składnia: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Sygnał dla zdarzeń związanych z anulowaniem interakcji. Zdarzenie wskazuje, czy przyczyną jest bezpośrednie anulowanie, czy błąd.

ActivityReceived

Składnia: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

Sygnały, że działanie zostało odebrane z zaplecza.

TurnStatusReceived

Składnia: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

Sygnały, że aktualizacja stanu kolei została odebrana z zaplecza.

Właściwości

Składnia: public PropertyCollection & Properties;

Kolekcja właściwości i ich wartości zdefiniowanych dla tego elementu DialogServiceConnector.

~DialogServiceConnector

Składnia: public inline virtual ~DialogServiceConnector ( );

Niszczy wystąpienie.

Connectasync

Składnia: public inline std::future< void > ConnectAsync ( );

Łączy się z zapleczem.

Zwraca

Operacja asynchroniczna, która uruchamia połączenie.

DisconnectAsync

Składnia: public inline std::future< void > DisconnectAsync ( );

Odłącza się od zaplecza.

Zwraca

Operacja asynchroniczna, która uruchamia rozłączenie.

SendActivityAsync

Składnia: public inline std::future< std::string > SendActivityAsync ( const std::string & activity );

Wysyła działanie do okna dialogowego tworzenia kopii zapasowej.

Parametry

  • activity Działanie do wysłania

Zwraca

Operacja asynchroniczna, która uruchamia operację.

StartKeywordRecognitionAsync

Składnia: public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Inicjuje rozpoznawanie słów kluczowych.

Parametry

  • model Określa model słów kluczowych do użycia.

Zwraca

Operacja asynchroniczna, która uruchamia operację.

StopKeywordRecognitionAsync

Składnia: public inline std::future< void > StopKeywordRecognitionAsync ( );

Zatrzymaj rozpoznawanie słów kluczowych.

Zwraca

Operacja asynchroniczna, która uruchamia operację.

ListenOnceAsync

Składnia: public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );

Uruchamia sesję nasłuchiwania, która zakończy się po pierwszej wypowiedzi.

Zwraca

Operacja asynchroniczna, która uruchamia operację.

StopListeningAsync

Składnia: public inline std::future< void > StopListeningAsync ( );

Żądania natychmiastowego zakończenia aktywnej operacji nasłuchiwania, przerwania jakichkolwiek trwających wypowiedzi i dostarczenia wyniku odzwierciedlającego wszystkie dane audio, które zostały do tej pory przechwycone.

Zwraca

Zadanie reprezentujące operację asynchroniczną, która zatrzymuje aktywną sesję nasłuchiwania.

SetAuthorizationToken

Składnia: public inline void SetAuthorizationToken ( const std::string & token );

Ustawia token autoryzacji, który będzie używany do nawiązywania połączenia z usługą. Uwaga: obiekt wywołujący musi upewnić się, że token autoryzacji jest prawidłowy. Przed wygaśnięciem tokenu autoryzacji obiekt wywołujący musi go odświeżyć, wywołując go przez wywołanie tego ustawiacza przy użyciu nowego prawidłowego tokenu. W przeciwnym razie łącznik napotka błędy podczas jego działania.

Parametry

  • token Token autoryzacji.

GetAuthorizationToken

Składnia: public inline std::string GetAuthorizationToken ( );

Pobiera token autoryzacji.

Zwraca

Token autoryzacji

SetSpeechActivityTemplate

Składnia: public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );

Ustawia szablon JSON, który zostanie udostępniony usłudze mowy na potrzeby następnej konwersacji. Usługa podejmie próbę scalenia tego szablonu ze wszystkimi działaniami wysłanymi do zaplecza okna dialogowego, niezależnie od tego, czy pochodzi on z klienta za pomocą funkcji SendActivityAsync, czy wygenerowanej przez usługę, podobnie jak w przypadku wyników zamiany mowy na tekst.

Parametry

  • activityTemplate Ładunek działania, jako ciąg JSON, który ma zostać scalony ze wszystkimi odpowiednimi komunikatami o działaniach.

GetSpeechActivityTemplate

Składnia: public inline std::string GetSpeechActivityTemplate ( );

Pobiera szablon JSON, który zostanie udostępniony usłudze mowy na potrzeby następnej konwersacji. Usługa podejmie próbę scalenia tego szablonu ze wszystkimi działaniami wysłanymi do zaplecza okna dialogowego, niezależnie od tego, czy pochodzi on z klienta za pomocą funkcji SendActivityAsync, czy wygenerowanej przez usługę, podobnie jak w przypadku wyników zamiany mowy na tekst.

Zwraca

Szablon działania JSON jest obecnie ustawiony, który będzie używany w kolejnych żądaniach.

Z konfiguracji

Składnia: public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );

Tworzy łącznik usługi okna dialogowego z pliku DialogServiceConfig i audio::AudioConfig. Użytkownicy powinni użyć tej funkcji do utworzenia łącznika usługi okna dialogowego.

Parametry

  • connectorConfig Konfiguracja usługi okna dialogowego.

  • audioConfig Konfiguracja dźwięku.

Zwraca

Udostępniony inteligentny wskaźnik utworzonego łącznika usługi okna dialogowego.

auto audioConfig = [Audio::AudioConfig::FromDefaultMicrophoneInput](audio-audioconfig.md#fromdefaultmicrophoneinput)();
auto config = [CustomCommandsConfig::FromAuthorizationToken](dialog-customcommandsconfig.md#fromauthorizationtoken)("my_app_id","my_auth_token", "my_region");
auto connector = [DialogServiceConnector::FromConfig](#fromconfig)(config, audioConfig);

W przypadku klasy DialogServiceConfig odwołujemy się do jednej z klas dziedzicujących po niej. Określona klasa do użycia zależy od używanego zaplecza okna dialogowego: