Connection Clase

Definición

Espacio de nombres:

Microsoft.CognitiveServices.Speech

Ensamblado:

Microsoft.CognitiveServices.Speech.csharp.dll

Paquete:

Microsoft.CognitiveServices.Speech v1.34.0

Clase de proxy para administrar la conexión al servicio de voz del reconocedor especificado. Agregado en la versión 1.2.0

public sealed class Connection : IDisposable

type Connection = class
    interface IDisposable

Public NotInheritable Class Connection
Implements IDisposable

Herencia

Object

Connection

Implementaciones

IDisposable

Comentarios

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 que puede usar para abrir o cerrar explícitamente una conexión y 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, puede 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. 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.

Métodos

Close()	Cierra la conexión del servicio. Opcionalmente, puede llamar a Close() 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.
Dispose()	Elimine los recursos asociados.
Finalize()	Clase de proxy para administrar la conexión al servicio de voz del reconocedor especificado. Agregado en la versión 1.2.0
FromConversationTranslator(ConversationTranslator)	Obtiene la instancia de Connection del traductor de conversación.
FromDialogServiceConnector(DialogServiceConnector)	Obtiene la instancia connection del conector de servicio de diálogo especificado, que se usa para observar y administrar la conexión y la desconexión del servicio de voz.
FromRecognizer(Recognizer)	Obtiene la instancia de Connection del reconocedor especificado.
FromSpeechSynthesizer(SpeechSynthesizer)	Obtiene la instancia connection del sintetizador de voz especificado, que se usa para observar y administrar la conexión y la desconexión del servicio de voz. Agregado en la versión 1.17.0
Open(Boolean)	Comienza a configurar la conexión al servicio. Opcionalmente, puede llamar a Open() 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 Open(), 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.
SendMessageAsync(String, Byte[], UInt32)	Envía un mensaje binario al servicio de voz como una operación asincrónica. Nota: Este método no funciona para la conexión de SpeechSynthesizer. Agregado en la versión 1.10.0
SendMessageAsync(String, String)	Envía un mensaje al servicio voz como una operación asincrónica. Nota: Este método no funciona para la conexión de SpeechSynthesizer. Agregado en la versión 1.7.0
SetMessageProperty(String, String, String)	Anexa un parámetro de un mensaje al servicio. Nota: Este método no funciona para la conexión de SpeechSynthesizer. Agregado en la versión 1.7.0

Eventos

Connected	Evento Connected para indicar que el reconocedor está conectado al servicio. Para recibir el evento Connected 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	Evento Disconnected para indicar que el reconocedor está desconectado del servicio. Para recibir el evento Disconnected 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	El evento MessageReceived indica que el servicio ha enviado un mensaje de red al cliente.