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.

Członkowie

Rozpoznane

Składnia: public EventSignal< const SpeechRecognitionEventArgs & > Recognized;

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

Uznając

Składnia: public EventSignal< const SpeechRecognitionEventArgs & > Recognizing;

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

Sesjastartowana

Składnia: public EventSignal< const SessionEventArgs & > SessionStarted;

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

SessionStopped

Składnia: public EventSignal< const SessionEventArgs & > SessionStopped;

Sygnał wskazujący koniec sesji nasłuchiwania.

SpeechStartDetected

Składnia: public EventSignal< const RecognitionEventArgs & > SpeechStartDetected;

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

SpeechEndDetected

Składnia: public EventSignal< const RecognitionEventArgs & > SpeechEndDetected;

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

Anulowane

Składnia: public EventSignal< const SpeechRecognitionCanceledEventArgs & > 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< const ActivityReceivedEventArgs & > ActivityReceived;

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

TurnStatusReceived

Składnia: public EventSignal< const TurnStatusReceivedEventArgs & > 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 obiektu 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

  • działanie activity 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 mówienia 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. Zanim token autoryzacji wygaśnie, obiekt wywołujący musi go odświeżyć, wywołując ten setter z nowym prawidłowym tokenem. 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 od klienta z usługą SendActivityAsync, czy wygenerowaną 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 aktywności.

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 od klienta z usługą SendActivityAsync, czy wygenerowaną 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 DialogServiceConfig i Audio::AudioConfig. Użytkownicy powinni użyć tej funkcji do utworzenia łącznika usługi dialogowej.

Parametry

  • connectorConfig konfiguracja usługi dialogowej.

  • audioConfig konfiguracja audio.

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 DialogServiceConfig odnosimy się do jednej z klas dziedziczących z niej. Określona klasa do użycia zależy od używanego zaplecza okna dialogowego: