Clase Connection

class Connection
  : public std::enable_shared_from_this< Connection >

Connection es una clase de proxy para administrar la conexión al servicio de voz del reconocedor especificado. De forma predeterminada, un Reconocedor administra de forma autónoma la conexión con el servicio cuando sea necesario. La clase Connection proporciona métodos adicionales para que los usuarios abran o cierren explícitamente una conexión y para suscribirse 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 a Open() para iniciar manualmente una conexión de servicio antes de iniciar el reconocimiento en el reconocedor asociado a esta conexión. Después de iniciar un reconocimiento, es posible que se produzca un error al llamar a Open() o Close(). Esto no afectará al reconocedor ni al reconocimiento continuo. La conexión puede quitarse por varias razones, el Reconocedor siempre intentará reinstituer la conexión según sea necesario para garantizar las operaciones en curso. En todos estos casos, los eventos conectados o desconectados indicarán el cambio del estado de conexión. Actualizado en la versión 1.17.0.

Miembros

Conexo

Sintaxis: public EventSignal< const ConnectionEventArgs & > Connected;

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

Desconectado

Sintaxis: public EventSignal< const ConnectionEventArgs & > Disconnected;

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

MessageReceived

Sintaxis: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

Evento MessageReceived para indicar que el protocolo subyacente recibió un mensaje del servicio. Se agregó en la versión 1.10.0.

Abrir

Sintaxis: public inline void Open ( bool forContinuousRecognition );

Comienza a configurar la conexión con el servicio. Los usuarios pueden llamar opcionalmente a Open() para configurar manualmente una conexión de antemano antes de iniciar el reconocimiento o la síntesis en el reconocedor o sintetizador asociado a esta conexión. Después de iniciar el reconocimiento, es posible que se produzca un error al llamar a Open(), en función del estado del proceso del reconocedor o sintetizador. Pero el error no afecta al estado del reconocedor o sintetizador asociado. Nota: Al devolver, es posible que la conexión aún no esté lista. Suscríbase al evento Connected para recibir una notificación cuando se establezca la conexión.

Parámetros

• forContinuousRecognition 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.

Cerrar

Sintaxis: public inline void Close ( );

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

SetMessageProperty

Sintaxis: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Anexa un parámetro de un mensaje al servicio. Se agregó en la versión 1.7.0.

Parámetros

• path la ruta de acceso del mensaje.

• propertyName Nombre de la propiedad.

• propertyValue Valor de la propiedad . Se trata de una cadena json.

Devoluciones

vacío.

SendMessageAsync

Sintaxis: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Envíe un mensaje al servicio de voz. Se agregó en la versión 1.7.0.

Parámetros

• path La ruta de acceso del mensaje.

• payload La carga del mensaje. Se trata de una cadena json.

Devoluciones

Un futuro vacío.

SendMessageAsync

Sintaxis: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Envíe un mensaje binario al servicio de voz. Este método no funciona para la conexión de SpeechSynthesizer. Se agregó en la versión 1.10.0.

Parámetros

• path La ruta de acceso del mensaje.

• payload La carga binaria del mensaje.

• size Tamaño de la carga binaria.

Devoluciones

Un futuro vacío.

Conexión

Sintaxis: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Constructor interno. Crea una nueva instancia mediante el identificador proporcionado.

Parámetros

• handle identificador de conexión.

~Conexión

Sintaxis: public inline ~Connection ( );

Destructor.

FromRecognizer

Sintaxis: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Obtiene la instancia de Connection del reconocedor especificado.

Parámetros

• recognizer el reconocedor asociado a la conexión.

Devoluciones

Instancia de connection del reconocedor.

FromConversationTranslator

Sintaxis: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Obtiene la instancia de connection del traductor de conversación especificado.

Parámetros

• convTrans Traductor de conversación asociado a la conexión.

Devoluciones

Instancia de conexión del traductor de conversación.

FromDialogServiceConnector

Sintaxis: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Obtiene la instancia de conexión del conector del servicio de diálogo especificado, que se usa para observar y administrar la conexión y la desconexión del servicio de voz.

Parámetros

• dialogServiceConnector El conector del servicio de diálogo asociado a la conexión.

Devoluciones

Instancia de conexión del conector del servicio de diálogo.

FromSpeechSynthesizer

Sintaxis: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Obtiene la instancia de connection del sintetizador de voz especificado. Se agregó en la versión 1.17.0.

Parámetros

• synthesizer El sintetizador de voz asociado a la conexión.

Devoluciones

Instancia de conexión del sintetizador de voz.