Connection Třída

Třída proxy pro správu připojení k řečové službě zadaného Recognizerobjektu .

Ve výchozím nastavení nezávisle Recognizer spravuje připojení ke službě v případě potřeby. Třída Connection poskytuje uživatelům další metody explicitně otevřít nebo zavřít připojení a přihlásit se k odběru změn stavu připojení. Použití je Connection volitelné. Je určená pro scénáře, kde je potřeba doladit chování aplikace na základě stavu připojení. Uživatelé mohou volitelně volat open , aby ručně inicializovali připojení služby před zahájením rozpoznávání u přidruženého Recognizer k tomuto Connection. Po spuštění rozpoznávání může volání open nebo close selhat. To nebude mít vliv na rozpoznávání ani probíhající rozpoznávání. Připojení může z různých důvodů vypadnout. Rozpoznávání se vždy pokusí znovu vytvořit připojení podle potřeby, aby se zajistily průběžné operace. Ve všech těchto případech connected/disconnected události oznamují změnu stavu připojení.

Poznámka

Aktualizováno ve verzi 1.17.0.

Konstruktor pro interní použití.

Dědičnost

builtins.object

Connection

Konstruktor

Connection(handle: c_void_p)

Parametry

Name	Description
handle Vyžadováno

Metody

close	Ukončí připojení služby. Uživatelé mohou volitelně volat close a ručně vypnout připojení přidruženého Recognizer. Volání může selhat v závislosti na stavu Recognizerprocesu . Selhání však nemá vliv na stav přidruženého Recognizer.
from_dialog_service_connector	Connection Získá instanci ze zadaného konektoru služby dialogového okna.
from_recognizer	Connection Získá instanci ze zadaného rozpoznávání.
from_speech_synthesizer	Connection Získá instanci ze zadaného syntetizátoru řeči. Poznámka Přidáno ve verzi 1.17.0.
open	Spustí nastavení připojení ke službě. Uživatelé mohou volitelně volat open , aby ručně předem nastavili připojení před zahájením rozpoznávání u Recognizer položky přidružené k tomuto Connection. Po spuštění rozpoznávání může volání open) selhat v závislosti na stavu Recognizerprocesu . Selhání však nemá vliv na stav přidruženého Recognizer. Poznámka Po návratu nemusí být připojení ještě připravené. Přihlaste se k odběru připojená událost, která má být upozorněna po navázání připojení.
set_message_property	Připojí parametr ve zprávě ke službě. Poznámka Tato metoda nefunguje pro připojení k SpeechSynthesizer.

close

Ukončí připojení služby. Uživatelé mohou volitelně volat close a ručně vypnout připojení přidruženého Recognizer. Volání může selhat v závislosti na stavu Recognizerprocesu . Selhání však nemá vliv na stav přidruženého Recognizer.

close()

from_dialog_service_connector

Connection Získá instanci ze zadaného konektoru služby dialogového okna.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parametry

Name	Description
dialog_service_connector Vyžadováno

from_recognizer

Connection Získá instanci ze zadaného rozpoznávání.

from_recognizer(recognizer: Recognizer) -> Connection

Parametry

Name	Description
recognizer Vyžadováno

from_speech_synthesizer

Connection Získá instanci ze zadaného syntetizátoru řeči.

Poznámka

Přidáno ve verzi 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parametry

Name	Description
speech_synthesizer Vyžadováno

open

Spustí nastavení připojení ke službě. Uživatelé mohou volitelně volat open , aby ručně předem nastavili připojení před zahájením rozpoznávání u Recognizer položky přidružené k tomuto Connection. Po spuštění rozpoznávání může volání open) selhat v závislosti na stavu Recognizerprocesu . Selhání však nemá vliv na stav přidruženého Recognizer.

Poznámka

Po návratu nemusí být připojení ještě připravené. Přihlaste se k odběru

připojená událost, která má být upozorněna po navázání připojení.

open(for_continuous_recognition: bool)

Parametry

Name	Description
forContinuousRecognition Vyžadováno	označuje, jestli se připojení používá k průběžnému rozpoznávání nebo k jednorázovému rozpoznávání. Pokud připojení pochází z speechSynthsizer, nemá to žádný vliv.
for_continuous_recognition Vyžadováno

set_message_property

Připojí parametr ve zprávě ke službě.

Poznámka

Tato metoda nefunguje pro připojení k SpeechSynthesizer.

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

Parametry

Name	Description
path Vyžadováno	Cesta ke zprávě.
property_name Vyžadováno	Název vlastnosti, kterou chcete nastavit.
property_value Vyžadováno	Hodnota vlastnosti, kterou chcete nastavit.

Atributy

connected

Událost Connected označuje, že je rozpoznávání připojeno ke službě.

disconnected

Událost Odpojeno má naznačovat, že je rozpoznávání odpojené od služby.