Connection Classe

Classe proxy pour la gestion de la connexion au service speech du spécifié Recognizer.

Par défaut, un gestionnaire Recognizer autonome de la connexion au service en cas de besoin. La Connection classe fournit des méthodes supplémentaires permettant aux utilisateurs d’ouvrir ou de fermer explicitement une connexion et de s’abonner aux modifications de status de connexion. L’utilisation de Connection est facultative. Il est destiné aux scénarios dans lesquels un réglage précis du comportement de l’application en fonction des status de connexion est nécessaire. Les utilisateurs peuvent éventuellement appeler open pour lancer manuellement une connexion de service avant de commencer la reconnaissance sur le Recognizer associé à ce Connection. Après avoir démarré une reconnaissance, l’appel open ou close peut échouer. Cela n’aura pas d’impact sur le module de reconnaissance ou la reconnaissance en cours. La connexion peut tomber pour diverses raisons. Le module de reconnaissance tente toujours de rétablir la connexion en fonction des besoins pour garantir les opérations en cours. Dans tous ces casconnected/disconnected, les événements indiquent la modification du status de connexion.

Notes

Mise à jour dans la version 1.17.0.

Constructeur à usage interne.

Héritage

builtins.object

Connection

Constructeur

Connection(handle: c_void_p)

Paramètres

Nom	Description
handle Obligatoire

Méthodes

close	Ferme la connexion au service. Les utilisateurs peuvent éventuellement appeler close pour arrêter manuellement la connexion du associé Recognizer. L’appel peut échouer, en fonction de l’état du processus de .Recognizer Mais l’échec n’affecte pas l’état du associé Recognizer.
from_dialog_service_connector	Obtient le Connection instance à partir du connecteur de service de dialogue spécifié.
from_recognizer	Obtient le Connection instance du module de reconnaissance spécifié.
from_speech_synthesizer	Obtient le Connection instance du synthétiseur vocal spécifié. Notes Ajouté dans la version 1.17.0.
open	Commence à configurer la connexion au service. Les utilisateurs peuvent éventuellement appeler open pour configurer manuellement une connexion à l’avance avant de commencer la reconnaissance sur le Recognizer associé à ce Connection. Après avoir démarré la reconnaissance, l’appel opende ) peut échouer, en fonction de l’état du processus de Recognizer. Mais l’échec n’affecte pas l’état du associé Recognizer. Notes Au retour, la connexion n’est peut-être pas encore prête. Abonnez-vous au événement connecté pour être averti lorsque la connexion est établie.
set_message_property	Ajoute un paramètre dans un message au service. Notes Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer.

close

Ferme la connexion au service. Les utilisateurs peuvent éventuellement appeler close pour arrêter manuellement la connexion du associé Recognizer. L’appel peut échouer, en fonction de l’état du processus de .Recognizer Mais l’échec n’affecte pas l’état du associé Recognizer.

close()

from_dialog_service_connector

Obtient le Connection instance à partir du connecteur de service de dialogue spécifié.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Paramètres

Nom	Description
dialog_service_connector Obligatoire

from_recognizer

Obtient le Connection instance du module de reconnaissance spécifié.

from_recognizer(recognizer: Recognizer) -> Connection

Paramètres

Nom	Description
recognizer Obligatoire

from_speech_synthesizer

Obtient le Connection instance du synthétiseur vocal spécifié.

Notes

Ajouté dans la version 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Paramètres

Nom	Description
speech_synthesizer Obligatoire

open

Commence à configurer la connexion au service. Les utilisateurs peuvent éventuellement appeler open pour configurer manuellement une connexion à l’avance avant de commencer la reconnaissance sur le Recognizer associé à ce Connection. Après avoir démarré la reconnaissance, l’appel opende ) peut échouer, en fonction de l’état du processus de Recognizer. Mais l’échec n’affecte pas l’état du associé Recognizer.

Notes

Au retour, la connexion n’est peut-être pas encore prête. Abonnez-vous au

événement connecté pour être averti lorsque la connexion est établie.

open(for_continuous_recognition: bool)

Paramètres

Nom	Description
forContinuousRecognition Obligatoire	indique si la connexion est utilisée pour la reconnaissance continue ou la reconnaissance à un seul coup. Elle ne prend aucun effet si la connexion provient de SpeechSynthsizer.
for_continuous_recognition Obligatoire

set_message_property

Ajoute un paramètre dans un message au service.

Notes

Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer.

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

Paramètres

Nom	Description
path Obligatoire	Chemin du message.
property_name Obligatoire	Nom de propriété que vous souhaitez définir.
property_value Obligatoire	Valeur de la propriété que vous souhaitez définir.

Attributs

connected

Événement Connected pour indiquer que le module de reconnaissance est connecté au service.

disconnected

Événement Disconnected pour indiquer que le module de reconnaissance est déconnecté du service.