Connection Klasse

Proxyklasse zum Verwalten der Verbindung mit dem Sprachdienst des angegebenen Recognizer.

Standardmäßig verwaltet ein Recognizer bei Bedarf autonom die Verbindung mit dem Dienst. Die Connection -Klasse stellt zusätzliche Methoden für Benutzer bereit, um eine Verbindung explizit zu öffnen oder zu schließen und verbindungs- status Änderungen zu abonnieren. Die Verwendung von Connection ist optional. Es ist für Szenarien vorgesehen, in denen eine Feinabstimmung des Anwendungsverhaltens basierend auf der Verbindung status erforderlich ist. Benutzer können optional aufrufen open , um manuell eine Dienstverbindung zu initiieren, bevor sie mit der Erkennung für die beginnen, die Recognizer diesem Connectionzugeordnet ist. Nach dem Starten einer Erkennung schlägt der Aufruf open oder close möglicherweise fehl. Dies wirkt sich nicht auf die Erkennung oder die laufende Erkennung aus. Die Verbindung kann aus verschiedenen Gründen getrennt werden. Die Erkennung versucht immer, die Verbindung wie erforderlich neu zu erstellen, um den laufenden Betrieb zu gewährleisten. In all diesen Fällen connected/disconnected weisen Ereignisse auf die Änderung der Verbindung status hin.

Hinweis

Aktualisiert in Version 1.17.0.

Konstruktor für die interne Verwendung.

Vererbung

builtins.object

Connection

Konstruktor

Connection(handle: c_void_p)

Parameter

Name	Beschreibung
handle Erforderlich

Methoden

close	Schließt die Verbindung des Diensts. Benutzer können optional aufrufen close , um die Verbindung der zugeordneten Recognizerzu beenden. Der Aufruf kann je nach Prozessstatus der Recognizerfehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand des zugeordneten Recognizeraus.
from_dialog_service_connector	Ruft die Connection instance aus dem angegebenen Dialogdienstconnector ab.
from_recognizer	Ruft die Connection instance von der angegebenen Erkennung ab.
from_speech_synthesizer	Ruft die Connection instance aus dem angegebenen Sprachsynthesizer ab. Hinweis In Version 1.17.0 hinzugefügt.
open	Beginnt mit dem Einrichten der Verbindung mit dem Dienst. Benutzer können optional aufrufen open , um eine Verbindung im Voraus manuell einzurichten, bevor sie mit der Erkennung der Recognizer diesem Connectionzugeordneten beginnen. Nach dem Starten der Erkennung kann der Aufruf openvon ) abhängig vom Prozessstatus von Recognizerfehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand des zugeordneten Recognizeraus. Hinweis Bei der Rückkehr ist die Verbindung möglicherweise noch nicht bereit. Abonnieren Sie die Connected-Ereignis, das benachrichtigt werden soll, wenn die Verbindung hergestellt wird.
set_message_property	Fügt einen Parameter in einer Nachricht an den Dienst an. Hinweis Diese Methode funktioniert nicht für die Verbindung von SpeechSynthesizer.

close

Schließt die Verbindung des Diensts. Benutzer können optional aufrufen close , um die Verbindung der zugeordneten Recognizerzu beenden. Der Aufruf kann je nach Prozessstatus der Recognizerfehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand des zugeordneten Recognizeraus.

close()

from_dialog_service_connector

Ruft die Connection instance aus dem angegebenen Dialogdienstconnector ab.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parameter

Name	Beschreibung
dialog_service_connector Erforderlich

from_recognizer

Ruft die Connection instance von der angegebenen Erkennung ab.

from_recognizer(recognizer: Recognizer) -> Connection

Parameter

Name	Beschreibung
recognizer Erforderlich

from_speech_synthesizer

Ruft die Connection instance aus dem angegebenen Sprachsynthesizer ab.

Hinweis

In Version 1.17.0 hinzugefügt.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parameter

Name	Beschreibung
speech_synthesizer Erforderlich

open

Beginnt mit dem Einrichten der Verbindung mit dem Dienst. Benutzer können optional aufrufen open , um eine Verbindung im Voraus manuell einzurichten, bevor sie mit der Erkennung der Recognizer diesem Connectionzugeordneten beginnen. Nach dem Starten der Erkennung kann der Aufruf openvon ) abhängig vom Prozessstatus von Recognizerfehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand des zugeordneten Recognizeraus.

Hinweis

Bei der Rückkehr ist die Verbindung möglicherweise noch nicht bereit. Abonnieren Sie die

Connected-Ereignis, das benachrichtigt werden soll, wenn die Verbindung hergestellt wird.

open(for_continuous_recognition: bool)

Parameter

Name	Beschreibung
forContinuousRecognition Erforderlich	gibt an, ob die Verbindung für die kontinuierliche Erkennung oder die Einzelschusserkennung verwendet wird. Es wird nicht wirksam, wenn die Verbindung über SpeechSynthsizer hergestellt wird.
for_continuous_recognition Erforderlich

set_message_property

Fügt einen Parameter in einer Nachricht an den Dienst an.

Hinweis

Diese Methode funktioniert nicht für die Verbindung von SpeechSynthesizer.

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

Parameter

Name	Beschreibung
path Erforderlich	Der Nachrichtenpfad.
property_name Erforderlich	Der Eigenschaftenname, den Sie festlegen möchten.
property_value Erforderlich	Der Wert der Eigenschaft, den Sie festlegen möchten.

Attribute

connected

Das Connected-Ereignis, das angibt, dass die Erkennung mit dem Dienst verbunden ist.

disconnected

Das Disconnected-Ereignis, das angibt, dass die Erkennung vom Dienst getrennt ist.