Partager via


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.