Connection Clase

Clase de proxy para administrar la conexión al servicio de voz del especificado Recognizer.

De forma predeterminada, un Recognizer objeto administra de forma autónoma la conexión al servicio cuando sea necesario. La Connection clase proporciona métodos adicionales para que los usuarios abran o cierren explícitamente una conexión y se suscriban a los cambios de estado de conexión. El uso de Connection es opcional. Está pensado para escenarios en los que se necesita un ajuste preciso del comportamiento de la aplicación en función del estado de conexión. Opcionalmente, los usuarios pueden llamar open a para iniciar manualmente una conexión de servicio antes de iniciar el reconocimiento en el Recognizer asociado a este Connection. Después de iniciar un reconocimiento, es posible que se produzca un error en la llamada open o close . Esto no afectará al reconocedor ni al reconocimiento continuo. Es posible que la conexión se quite por varios motivos, el reconocedor siempre intentará reinstituir la conexión según sea necesario para garantizar las operaciones en curso. En todos estos casos connected/disconnected , los eventos indicarán el cambio del estado de conexión.

Nota

Actualizado en la versión 1.17.0.

Constructor para uso interno.

Herencia

builtins.object

Connection

Constructor

Connection(handle: c_void_p)

Parámetros

Nombre	Description
handle Requerido

Métodos

close	Cierra la conexión del servicio. Opcionalmente, los usuarios pueden llamar close a para apagar manualmente la conexión del asociado Recognizer. Es posible que se produzca un error en la llamada, en función del estado del proceso de Recognizer. Pero el error no afecta al estado del asociado Recognizer.
from_dialog_service_connector	Obtiene la Connection instancia del conector de servicio de diálogo especificado.
from_recognizer	Obtiene la Connection instancia del reconocedor especificado.
from_speech_synthesizer	Obtiene la Connection instancia del sintetizador de voz especificado. Nota Se agregó en la versión 1.17.0.
open	Comienza a configurar la conexión al servicio. Opcionalmente, los usuarios pueden llamar open a para configurar manualmente una conexión de antemano antes de iniciar el reconocimiento en el Recognizer asociado a este Connection. Después de iniciar el reconocimiento, es posible que se produzca un error al llamar a open, en función del estado del proceso de Recognizer. Pero el error no afecta al estado del asociado Recognizer. Nota A cambio, es posible que la conexión aún no esté lista. Suscríbase al evento conectado que se notificará cuando se establezca la conexión.
set_message_property	Anexa un parámetro de un mensaje al servicio. Nota Este método no funciona para la conexión de SpeechSynthesizer.

close

Cierra la conexión del servicio. Opcionalmente, los usuarios pueden llamar close a para apagar manualmente la conexión del asociado Recognizer. Es posible que se produzca un error en la llamada, en función del estado del proceso de Recognizer. Pero el error no afecta al estado del asociado Recognizer.

close()

from_dialog_service_connector

Obtiene la Connection instancia del conector de servicio de diálogo especificado.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parámetros

Nombre	Description
dialog_service_connector Requerido

from_recognizer

Obtiene la Connection instancia del reconocedor especificado.

from_recognizer(recognizer: Recognizer) -> Connection

Parámetros

Nombre	Description
recognizer Requerido

from_speech_synthesizer

Obtiene la Connection instancia del sintetizador de voz especificado.

Nota

Se agregó en la versión 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parámetros

Nombre	Description
speech_synthesizer Requerido

open

Comienza a configurar la conexión al servicio. Opcionalmente, los usuarios pueden llamar open a para configurar manualmente una conexión de antemano antes de iniciar el reconocimiento en el Recognizer asociado a este Connection. Después de iniciar el reconocimiento, es posible que se produzca un error al llamar a open, en función del estado del proceso de Recognizer. Pero el error no afecta al estado del asociado Recognizer.

Nota

A cambio, es posible que la conexión aún no esté lista. Suscríbase al

evento conectado que se notificará cuando se establezca la conexión.

open(for_continuous_recognition: bool)

Parámetros

Nombre	Description
forContinuousRecognition Requerido	indica si la conexión se usa para el reconocimiento continuo o el reconocimiento de una sola captura. No surte efecto si la conexión procede de SpeechSynthsizer.
for_continuous_recognition Requerido

set_message_property

Anexa un parámetro de un mensaje al servicio.

Nota

Este método no funciona para la conexión de SpeechSynthesizer.

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

Parámetros

Nombre	Description
path Requerido	Ruta de acceso del mensaje.
property_name Requerido	Nombre de propiedad que desea establecer.
property_value Requerido	Valor de la propiedad que desea establecer.

Atributos

connected

Evento Connected para indicar que el reconocedor está conectado al servicio.

disconnected

Evento Disconnected para indicar que el reconocedor está desconectado del servicio.