DialogServiceConnector Klasa

Obiekt, który komunikuje się z systemem okien dialogowych z obsługą mowy przy użyciu platformy Bot Framework lub poleceń niestandardowych. Ten typ odbiera wyniki zamiany mowy na tekst, a także ułatwia asynchroniczne wysyłanie i odbieranie danych aktywności okna dialogowego bez mowy.

Dziedziczenie

builtins.object

DialogServiceConnector

Konstruktor

DialogServiceConnector(dialog_service_config: DialogServiceConfig, audio_config: AudioConfig | None = None)

Parametry

Nazwa	Opis
dialog_service_config Wymagane	Konfiguracja usługi dialogowej dla platformy botów lub poleceń niestandardowych.
audio_config	Konfiguracja danych wejściowych audio. wartość domyślna: None

Metody

connect	Synchronicznie ustanawia połączenie z usługą. Połączenie jest wykonywane automatycznie w razie potrzeby, ale to ręczne wywołanie może być przydatne, aby upewnić się, że połączenie jest aktywne przed pierwszym użyciem w celu zmniejszenia opóźnienia początkowego. Po powrocie połączenie może nie być jeszcze gotowe. Zasubskrybuj połączone zdarzenie wystąpienia połączenia , aby otrzymywać powiadomienia po nawiązaniu połączenia z usługą. Użyj polecenia Connection , aby pobrać wystąpienie przy użyciu from_dialog_service_connector metody .
connect_async	Asynchronicznie ustanawia połączenie z usługą. Połączenie jest wykonywane automatycznie w razie potrzeby, ale to ręczne wywołanie może być przydatne, aby upewnić się, że połączenie jest aktywne przed pierwszym użyciem w celu zmniejszenia opóźnienia początkowego.
disconnect	Synchronicznie rozłącza się z usługą. Kolejne wywołania wymagające połączenia będą nadal automatycznie ponownie nawiązane po ręcznym rozłączeniu.
disconnect_async	Asynchronicznie rozłącza się z usługą. Kolejne wywołania wymagające połączenia będą nadal automatycznie ponownie nawiązane po ręcznym rozłączeniu.
listen_once	Synchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem i blokuje do momentu odebrania wyniku końcowego pojedynczej mowy na tekst. Otrzymany wynik zamiany mowy na tekst jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system dialogowy może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania.
listen_once_async	Asynchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem i blokuje do momentu odebrania wyniku końcowego pojedynczej mowy na tekst. Otrzymany wynik zamiany mowy na tekst jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system dialogowy może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania.
send_activity	Synchronicznie wysyła ładunek danych do usługi zaplecza okna dialogowego, z którą jest połączone to wystąpienie programu DialogServiceConnector. Zazwyczaj jest to dokument JSON ze schematem określonym przez implementację okna dialogowego w usłudze, a zawartość wysłanego działania powinna być wypełniona wiedzą na temat formatu i oczekiwań dotyczących zawartości systemu okien dialogowych. Wysłane działania nie są skojarzone z żadną inną interakcją i będą generować własny autonomiczny identyfikator interakcji podczas przetwarzania przez usługę. Korelacja konwersacji i innych interakcji powinna odbywać się za pośrednictwem samego ładunku działania przy użyciu możliwości używanej implementacji okna dialogowego.
send_activity_async	Asynchronicznie wysyła działanie do okna dialogowego tworzenia kopii zapasowej, zobacz szczegóły opisu na stronie send_activity
start_keyword_recognition	Synchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem przy użyciu słowa kluczowego. Ta interakcja będzie używać dostarczonego modelu słowa kluczowego do nasłuchiwania słowa kluczowego na czas nieokreślony, podczas którego dźwięk nie jest wysyłany do usługi mowy, a wszystkie przetwarzanie jest wykonywane lokalnie. Po rozpoznaniu słowa kluczowego program DialogServiceConnector automatycznie połączy się z usługą rozpoznawania mowy i rozpocznie wysyłanie danych dźwiękowych z poziomu słowa kluczowego tuż przed wywołaniem słowa kluczowego.listen_once_async Po odebraniu wyniki zamiany mowy na tekst mogą być przetwarzane przez podaną procedurę obsługi wyników lub pobierane za pośrednictwem subskrypcji do rozpoznanego zdarzenia. Wynik zamiany mowy na tekst generowany przez tę operację jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system okien dialogowych może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania. Wywołaj metodę stop_keyword_recognition_async , aby zatrzymać rozpoznawanie inicjowane przez słowo kluczowe.
start_keyword_recognition_async	Asynchronicznie konfiguruje łącznik usługi dialogowej przy użyciu danego modelu słowa kluczowego. Po wywołaniu tej metody łącznik nasłuchuje słowa kluczowego , aby rozpocząć rozpoznawanie. Wywołaj metodę stop_keyword_recognition_async , aby zatrzymać rozpoznawanie inicjowane przez słowo kluczowe. Zobacz start_keyword_recognition , aby uzyskać szczegółowy opis funkcji.
stop_keyword_recognition	Synchronicznie zatrzymuje rozpoznawanie inicjowane przez słowo kluczowe.
stop_keyword_recognition_async	Asynchronicznie zatrzymuje rozpoznawanie inicjowane przez słowo kluczowe.
stop_listening	Żąda natychmiastowego zatrzymania każdej aktywnej operacji nasłuchiwania. Może to spowodować przerwanie interakcji zamiany mowy na tekst w toku, a każdy otrzymany wynik zamiany mowy na tekst może reprezentować niekompletne dane wejściowe mowy. Metody synchroniczne nie powinny być wywoływane podczas obsługi zdarzenia. Użyj polecenia stop_listening_async , jeśli w odpowiedzi na zdarzenie wymagane jest zatrzymanie.
stop_listening_async	Żąda natychmiastowego zatrzymania każdej aktywnej operacji nasłuchiwania. Może to spowodować przerwanie interakcji zamiany mowy na tekst w toku, a każdy otrzymany wynik zamiany mowy na tekst może reprezentować niekompletne dane wejściowe mowy.

connect

Synchronicznie ustanawia połączenie z usługą. Połączenie jest wykonywane automatycznie w razie potrzeby, ale to ręczne wywołanie może być przydatne, aby upewnić się, że połączenie jest aktywne przed pierwszym użyciem w celu zmniejszenia opóźnienia początkowego.

Po powrocie połączenie może nie być jeszcze gotowe. Zasubskrybuj połączone zdarzenie wystąpienia połączenia , aby otrzymywać powiadomienia po nawiązaniu połączenia z usługą. Użyj polecenia Connection , aby pobrać wystąpienie przy użyciu from_dialog_service_connector metody .

connect()

connect_async

Asynchronicznie ustanawia połączenie z usługą. Połączenie jest wykonywane automatycznie w razie potrzeby, ale to ręczne wywołanie może być przydatne, aby upewnić się, że połączenie jest aktywne przed pierwszym użyciem w celu zmniejszenia opóźnienia początkowego.

connect_async()

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po zainicjowaniu połączenia.

disconnect

Synchronicznie rozłącza się z usługą. Kolejne wywołania wymagające połączenia będą nadal automatycznie ponownie nawiązane po ręcznym rozłączeniu.

disconnect()

disconnect_async

Asynchronicznie rozłącza się z usługą. Kolejne wywołania wymagające połączenia będą nadal automatycznie ponownie nawiązane po ręcznym rozłączeniu.

disconnect_async()

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po rozłączeniu.

listen_once

Synchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem i blokuje do momentu odebrania wyniku końcowego pojedynczej mowy na tekst. Otrzymany wynik zamiany mowy na tekst jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system dialogowy może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania.

listen_once() -> SpeechRecognitionResult

Zwraca

Typ	Opis
	wynik zamiany mowy na tekst z rozpoznawania mowy.

listen_once_async

Asynchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem i blokuje do momentu odebrania wyniku końcowego pojedynczej mowy na tekst. Otrzymany wynik zamiany mowy na tekst jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system dialogowy może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania.

listen_once_async() -> ResultFuture

Zwraca

Typ	Opis
	Przyszłość zawierająca wartość wyniku zamiany mowy na tekst w funkcji rozpoznawania asynchronicznego.

send_activity

Synchronicznie wysyła ładunek danych do usługi zaplecza okna dialogowego, z którą jest połączone to wystąpienie programu DialogServiceConnector. Zazwyczaj jest to dokument JSON ze schematem określonym przez implementację okna dialogowego w usłudze, a zawartość wysłanego działania powinna być wypełniona wiedzą na temat formatu i oczekiwań dotyczących zawartości systemu okien dialogowych. Wysłane działania nie są skojarzone z żadną inną interakcją i będą generować własny autonomiczny identyfikator interakcji podczas przetwarzania przez usługę. Korelacja konwersacji i innych interakcji powinna odbywać się za pośrednictwem samego ładunku działania przy użyciu możliwości używanej implementacji okna dialogowego.

send_activity(activity: str) -> str

Parametry

Nazwa	Opis
activity Wymagane	serializowany ładunek działania do wysłania.

Zwraca

Typ

Opis

identyfikator interakcji uzyskany po potwierdzeniu działania przez usługę. Może się to zdarzyć, zanim działanie zostanie przetworzone i ocenione przez implementację okna dialogowego, a otrzymanie identyfikatora interakcji nie oznacza powodzenia ani niepowodzenia przetwarzania działania. Informacje o powodzeniu lub niepowodzeniu można uzyskać za pośrednictwem działań odpowiedzi z danymi korelacji lub zdarzeń TurnStatusReceived skorelowanych z tym identyfikatorem interakcji.

send_activity_async

Asynchronicznie wysyła działanie do okna dialogowego tworzenia kopii zapasowej, zobacz szczegóły opisu na stronie send_activity

send_activity_async(activity: str) -> ResultFuture

Parametry

Nazwa	Opis
activity Wymagane	serializowany ładunek działania do wysłania.

Zwraca

Typ	Opis
	Przyszłość zawierająca wartość wynikową operacji wysyłania działania asynchronicznego.

start_keyword_recognition

Synchronicznie rozpoczyna interakcję zamiany mowy na tekst z tym łącznikiem przy użyciu słowa kluczowego. Ta interakcja będzie używać dostarczonego modelu słowa kluczowego do nasłuchiwania słowa kluczowego na czas nieokreślony, podczas którego dźwięk nie jest wysyłany do usługi mowy, a wszystkie przetwarzanie jest wykonywane lokalnie. Po rozpoznaniu słowa kluczowego program DialogServiceConnector automatycznie połączy się z usługą rozpoznawania mowy i rozpocznie wysyłanie danych dźwiękowych z poziomu słowa kluczowego tuż przed wywołaniem słowa kluczowego.listen_once_async Po odebraniu wyniki zamiany mowy na tekst mogą być przetwarzane przez podaną procedurę obsługi wyników lub pobierane za pośrednictwem subskrypcji do rozpoznanego zdarzenia. Wynik zamiany mowy na tekst generowany przez tę operację jest również dostarczany do skonfigurowanej implementacji okna dialogowego, a system okien dialogowych może wygenerować dowolną liczbę ładunków działań w odpowiedzi na interakcję mowy. Interakcje mowy mogą być skorelowane z działaniami za pośrednictwem danych specyficznych dla okna dialogowego w ładunku działania.

Wywołaj metodę stop_keyword_recognition_async , aby zatrzymać rozpoznawanie inicjowane przez słowo kluczowe.

start_keyword_recognition(model: KeywordRecognitionModel)

Parametry

Nazwa	Opis
model Wymagane	model rozpoznawania słów kluczowych, który określa słowo kluczowe do rozpoznania.

start_keyword_recognition_async

Asynchronicznie konfiguruje łącznik usługi dialogowej przy użyciu danego modelu słowa kluczowego. Po wywołaniu tej metody łącznik nasłuchuje słowa kluczowego , aby rozpocząć rozpoznawanie. Wywołaj metodę stop_keyword_recognition_async , aby zatrzymać rozpoznawanie inicjowane przez słowo kluczowe.

Zobacz start_keyword_recognition , aby uzyskać szczegółowy opis funkcji.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parametry

Nazwa	Opis
model Wymagane	model rozpoznawania słów kluczowych, który określa słowo kluczowe do rozpoznania.

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po zainicjowaniu rozpoznawania.

stop_keyword_recognition

Synchronicznie zatrzymuje rozpoznawanie inicjowane przez słowo kluczowe.

stop_keyword_recognition()

stop_keyword_recognition_async

Asynchronicznie zatrzymuje rozpoznawanie inicjowane przez słowo kluczowe.

stop_keyword_recognition_async()

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po zatrzymaniu rozpoznawania.

stop_listening

Żąda natychmiastowego zatrzymania każdej aktywnej operacji nasłuchiwania. Może to spowodować przerwanie interakcji zamiany mowy na tekst w toku, a każdy otrzymany wynik zamiany mowy na tekst może reprezentować niekompletne dane wejściowe mowy.

Metody synchroniczne nie powinny być wywoływane podczas obsługi zdarzenia. Użyj polecenia stop_listening_async , jeśli w odpowiedzi na zdarzenie wymagane jest zatrzymanie.

stop_listening()

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po zatrzymaniu nasłuchiwania.

stop_listening_async

Żąda natychmiastowego zatrzymania każdej aktywnej operacji nasłuchiwania. Może to spowodować przerwanie interakcji zamiany mowy na tekst w toku, a każdy otrzymany wynik zamiany mowy na tekst może reprezentować niekompletne dane wejściowe mowy.

stop_listening_async()

Zwraca

Typ	Opis
	Przyszłość, która zostanie spełniona po zatrzymaniu nasłuchiwania.

Atrybuty

activity_received

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

Wywołania zwrotne połączone z tym sygnałem ActivityReceivedEventArgssą wywoływane za pomocą wystąpienia , jako pojedynczego argumentu zależnego od typu aparatu rozpoznawania.

authorization_token

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

token autoryzacji wygaśnie. Obiekt wywołujący musi go odświeżyć przez wywołanie tego elementu ustawiającego za pomocą elementu

nowy prawidłowy token. W przeciwnym razie aparat rozpoznawania napotka błędy podczas rozpoznawania.

canceled

Sygnał dla zdarzeń zawierających anulowane wyniki rozpoznawania (wskazujący próbę rozpoznawania anulowaną w wyniku lub żądanie anulowania bezpośredniego lub, alternatywnie, błąd transportu lub protokołu).

Wywołania zwrotne połączone z tym sygnałem SpeechRecognitionCanceledEventArgssą wywoływane za pomocą wystąpienia , jako pojedynczego argumentu.

recognized

Sygnał dla zdarzeń zawierających wyniki końcowego rozpoznawania (wskazujący pomyślną próbę rozpoznawania).

Wywołania zwrotne połączone z tym sygnałem SpeechRecognitionEventArgssą wywoływane za pomocą wystąpienia , jako pojedynczego argumentu zależnego od typu aparatu rozpoznawania.

recognizing

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

Wywołania zwrotne połączone z tym sygnałem SpeechRecognitionEventArgssą wywoływane za pomocą wystąpienia , jako pojedynczego argumentu.

session_started

Sygnał dla zdarzeń wskazujący początek sesji rozpoznawania (operacja).

Wywołania zwrotne połączone z tym sygnałem są wywoływane z wystąpieniem SessionEventArgs jako pojedynczy argument.

session_stopped

Sygnał dla zdarzeń wskazujący koniec sesji rozpoznawania (operacja).

Wywołania zwrotne połączone z tym sygnałem są wywoływane z wystąpieniem SessionEventArgs jako pojedynczy argument.

speech_activity_template

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 wysyłanymi do zaplecza okna dialogowego, niezależnie od tego, czy pochodzi on z klienta za pomocą funkcji SendActivityAsync, czy wygenerowany przez usługę, podobnie jak w przypadku wyników zamiany mowy na tekst.

speech_end_detected

Sygnał dla zdarzeń wskazujący koniec mowy.

Wywołania zwrotne połączone z tym sygnałem są wywoływane z wystąpieniem RecognitionEventArgs jako pojedynczy argument.

speech_start_detected

Sygnał dla zdarzeń wskazujący początek mowy.

Wywołania zwrotne połączone z tym sygnałem są wywoływane z wystąpieniem RecognitionEventArgs jako pojedynczy argument.

turn_status_received

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

Wywołania zwrotne połączone z tym sygnałem TurnStatusReceivedEventArgssą wywoływane za pomocą wystąpienia , jako pojedynczego argumentu.