okno dialogowe klasy::D ialogServiceConnector
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:
BotFrameworkConfig for DirectLineSpeech
CustomCommandsConfig for CustomCommands