Connection Clase

Paquete:

com.microsoft.cognitiveservices.speech

Artefacto Maven:

com.microsoft.cognitiveservices.speech:client-sdk:1.34.0

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.Connection

Implementaciones

java.lang.AutoCloseable

public final class Connection
implements java.lang.AutoCloseable

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 al servicio cuando sea necesario. La clase Connection proporciona métodos adicionales para que los usuarios abran o cierren explícitamente una conexión y se suscriba 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 openConnection() 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 openConnection() o closeConnection(). 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, los eventos Connected/Disconnected indicarán el cambio del estado de conexión. Nota: se debe llamar a close() para liberar los recursos subyacentes mantenidos por el objeto . Actualizado en la versión 1.17.0.

Resumen del campo

Modificador y tipo	Campo y descripción
final EventHandlerImpl<ConnectionEventArgs>	connected Evento Connected para indicar que el reconocedor está conectado al servicio.
final EventHandlerImpl<ConnectionEventArgs>	disconnected Evento Disconnected para indicar que el reconocedor está desconectado del servicio.
final EventHandlerImpl<ConnectionMessageEventArgs>	messageReceived El evento MessageReceived indica que el servicio ha enviado un mensaje de red al cliente.

Resumen del método

Modificador y tipo	Método y descripción
void	close() Elimine los recursos asociados.
void	closeConnection() Cierra la conexión del servicio.
static Connection	fromConversationTranslator(ConversationTranslator conversationTranslator) Obtiene la instancia de Connection del traductor de conversación.
static Connection	fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector) Obtiene la instancia de conexión del conector del servicio de diálogo.
static Connection	fromRecognizer(Recognizer recognizer) Obtiene la instancia de Connection del reconocedor especificado.
static Connection	fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer) Obtiene la instancia de Connection del sintetizador de voz.
void	openConnection(boolean forContinuousRecognition) Comienza a configurar la conexión al servicio.
java.util.concurrent.Future<java.lang.Void>	sendMessageAsync(String path, String payload) Envía un mensaje al servicio.
void	setMessageProperty(String path, String propertyName, String propertyValue) Anexa un parámetro de un mensaje al servicio.

Métodos heredados de java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Detalles del campo

connected

public final EventHandlerImpl connected

Evento Connected para indicar que el reconocedor está conectado al servicio. Para recibir el evento conectado después de suscribirse a él, el propio objeto Connection debe estar activo. Si el objeto Connection que posee este evento está fuera de su tiempo de vida, no se entregarán todos los eventos suscritos.

disconnected

public final EventHandlerImpl disconnected

Evento Disconnected para indicar que el reconocedor está desconectado del servicio. Para recibir el evento desconectado después de suscribirse a él, el propio objeto Connection debe estar activo. Si el objeto Connection que posee este evento está fuera de su tiempo de vida, no se entregarán todos los eventos suscritos.

messageReceived

public final EventHandlerImpl messageReceived

El evento MessageReceived indica que el servicio ha enviado un mensaje de red al cliente. Se agregó en la versión 1.15.0.

Detalles del método

close

public void close()

Elimine los recursos asociados. Se debe llamar a close() para renunciar correctamente a los recursos subyacentes.

closeConnection

public void closeConnection()

Cierra la conexión del servicio. Opcionalmente, los usuarios pueden llamar a closeConnection() para apagar manualmente la conexión del reconocedor asociado. 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 reconocedor asociado.

fromConversationTranslator

public static Connection fromConversationTranslator(ConversationTranslator conversationTranslator)

Obtiene la instancia de Connection del traductor de conversación.

Parameters:

conversationTranslator - ConversationTranslator asociado a la conexión.

Returns:

Instancia de connection del reconocedor.

fromDialogServiceConnector

public static Connection fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector)

Obtiene la instancia de conexión del conector del servicio de diálogo.

Parameters:

dialogServiceConnector - Conector del servicio de diálogo asociado a la conexión, que se usa para observar y administrar el estado de conexión con el servicio de voz.

Returns:

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

fromRecognizer

public static Connection fromRecognizer(Recognizer recognizer)

Obtiene la instancia de Connection del reconocedor especificado.

Parameters:

recognizer - Reconocedor asociado a la conexión.

Returns:

Instancia de connection del reconocedor.

fromSpeechSynthesizer

public static Connection fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer)

Obtiene la instancia de Connection del sintetizador de voz. Agregado en la versión 1.17.0

Parameters:

speechSynthesizer - Sintetizador de voz asociado a la conexión, que se usa para observar y administrar el estado de conexión con el servicio de voz.

Returns:

Instancia de conexión del sintetizador de voz.

openConnection

public void openConnection(boolean forContinuousRecognition)

Comienza a configurar la conexión al servicio. Opcionalmente, los usuarios pueden llamar a openConnection() para configurar manualmente una conexión de antemano antes de iniciar el reconocimiento en el reconocedor asociado a esta conexión. Después de iniciar el reconocimiento, es posible que se produzca un error al llamar a OpenConnection(), en función del estado del proceso de Recognizer. Pero el error no afecta al estado del reconocedor 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.

Parameters:

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.

sendMessageAsync

public Future sendMessageAsync(String path, String payload)

Envía un mensaje al servicio. Se agregó en la versión 1.7.0 Nota: Este método no funciona para la conexión de SpeechSynthesizer.

Parameters:

path - Ruta de acceso del mensaje.

payload - Carga del mensaje.

Returns:

un futuro que representa la operación asincrónica que envía el mensaje.

setMessageProperty

public void setMessageProperty(String path, String propertyName, String propertyValue)

Anexa un parámetro de un mensaje al servicio. Se agregó en la versión 1.7.0 Nota: Este método no funciona para la conexión de SpeechSynthesizer.

Parameters:

path - Ruta de acceso del mensaje.

propertyName - Nombre de propiedad que desea establecer.

propertyValue - Valor de la propiedad que desea establecer.