Connection Klasa

Klasa serwera proxy do zarządzania połączeniem z usługą mowy określonego Recognizerelementu .

Domyślnie autonomicznie zarządza połączeniem z usługą w Recognizer razie potrzeby. Klasa Connection udostępnia dodatkowe metody umożliwiające użytkownikom jawne otwieranie lub zamykanie połączenia oraz subskrybowanie zmian stanu połączenia. Użycie elementu Connection jest opcjonalne. Jest ona przeznaczona dla scenariuszy, w których potrzebne jest dostrajanie zachowania aplikacji na podstawie stanu połączenia. Użytkownicy mogą opcjonalnie wywołać open metodę w celu ręcznego zainicjowania połączenia z usługą przed rozpoczęciem rozpoznawania skojarzonego Recognizer z tym Connectionelementem . Po uruchomieniu rozpoznawania wywołanie metody lub close może zakończyć się niepowodzeniemopen. Nie będzie to miało wpływu na rozpoznawanie ani bieżące rozpoznawanie. Połączenie może zostać porzucene z różnych powodów. Usługa Recognizer zawsze podejmie próbę przywrócenia połączenia zgodnie z wymaganiami w celu zagwarantowania bieżących operacji. We wszystkich tych przypadkach connected/disconnected zdarzenia będą wskazywać zmianę stanu połączenia.

Uwaga

Zaktualizowano w wersji 1.17.0.

Konstruktor do użytku wewnętrznego.

Dziedziczenie

builtins.object

Connection

Konstruktor

Connection(handle: c_void_p)

Parametry

Nazwa	Opis
handle Wymagane

Metody

close	Zamyka połączenie z usługą. Użytkownicy mogą opcjonalnie wywołać close metodę , aby ręcznie zamknąć połączenie skojarzonego Recognizerelementu . Wywołanie może zakończyć się niepowodzeniem w zależności od stanu procesu .Recognizer Jednak awaria nie ma wpływu na stan skojarzonego Recognizerelementu .
from_dialog_service_connector	Connection Pobiera wystąpienie z określonego łącznika usługi okna dialogowego.
from_recognizer	Connection Pobiera wystąpienie z określonego rozpoznawania.
from_speech_synthesizer	Connection Pobiera wystąpienie z określonego syntetyzatora mowy. Uwaga Dodano element w wersji 1.17.0.
open	Rozpoczyna konfigurowanie połączenia z usługą. Użytkownicy mogą opcjonalnie wywołać open metodę ręcznego konfigurowania połączenia z wyprzedzeniem przed rozpoczęciem rozpoznawania w środowisku skojarzonym Recognizer z tym Connectionelementem . Po rozpoczęciu rozpoznawania wywołanie openmetody ) może zakończyć się niepowodzeniem w zależności od stanu Recognizerprocesu . Jednak awaria nie ma wpływu na stan skojarzonego Recognizerelementu . Uwaga Po powrocie połączenie może nie być jeszcze gotowe. Zasubskrybuj zdarzenie połączone, które ma być powiadamiane o nawiązaniu połączenia.
set_message_property	Dołącza parametr w komunikacie do usługi. Uwaga Ta metoda nie działa w przypadku połączenia z programem SpeechSynthesizer.

close

Zamyka połączenie z usługą. Użytkownicy mogą opcjonalnie wywołać close metodę , aby ręcznie zamknąć połączenie skojarzonego Recognizerelementu . Wywołanie może zakończyć się niepowodzeniem w zależności od stanu procesu .Recognizer Jednak awaria nie ma wpływu na stan skojarzonego Recognizerelementu .

close()

from_dialog_service_connector

Connection Pobiera wystąpienie z określonego łącznika usługi okna dialogowego.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parametry

Nazwa	Opis
dialog_service_connector Wymagane

from_recognizer

Connection Pobiera wystąpienie z określonego rozpoznawania.

from_recognizer(recognizer: Recognizer) -> Connection

Parametry

Nazwa	Opis
recognizer Wymagane

from_speech_synthesizer

Connection Pobiera wystąpienie z określonego syntetyzatora mowy.

Uwaga

Dodano element w wersji 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parametry

Nazwa	Opis
speech_synthesizer Wymagane

open

Rozpoczyna konfigurowanie połączenia z usługą. Użytkownicy mogą opcjonalnie wywołać open metodę ręcznego konfigurowania połączenia z wyprzedzeniem przed rozpoczęciem rozpoznawania w środowisku skojarzonym Recognizer z tym Connectionelementem . Po rozpoczęciu rozpoznawania wywołanie openmetody ) może zakończyć się niepowodzeniem w zależności od stanu Recognizerprocesu . Jednak awaria nie ma wpływu na stan skojarzonego Recognizerelementu .

Uwaga

Po powrocie połączenie może nie być jeszcze gotowe. Zasubskrybuj

zdarzenie połączone, które ma być powiadamiane o nawiązaniu połączenia.

open(for_continuous_recognition: bool)

Parametry

Nazwa	Opis
forContinuousRecognition Wymagane	wskazuje, czy połączenie jest używane do rozpoznawania ciągłego, czy rozpoznawania pojedynczego strzału. Nie ma to wpływu, jeśli połączenie pochodzi z narzędzia SpeechSynthsizer.
for_continuous_recognition Wymagane

set_message_property

Dołącza parametr w komunikacie do usługi.

Uwaga

Ta metoda nie działa w przypadku połączenia z programem SpeechSynthesizer.

set_message_property(path: str, property_name: str, property_value: str)

Parametry

Nazwa	Opis
path Wymagane	Ścieżka komunikatu.
property_name Wymagane	Nazwa właściwości, którą chcesz ustawić.
property_value Wymagane	Wartość właściwości, którą chcesz ustawić.

Atrybuty

connected

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

disconnected

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