Connection Classe

Définition

Espace de noms:

Microsoft.CognitiveServices.Speech

Assembly:

Microsoft.CognitiveServices.Speech.csharp.dll

Paquet:

Microsoft.CognitiveServices.Speech v1.34.0

Classe proxy pour la gestion de la connexion au service speech du module De reconnaissance spécifié. Ajouté dans la version 1.2.0

public sealed class Connection : IDisposable

type Connection = class
    interface IDisposable

Public NotInheritable Class Connection
Implements IDisposable

Héritage

Object

Connection

Implémente

IDisposable

Remarques

Par défaut, un module Recognizer gère de manière autonome la connexion au service si nécessaire. La classe Connection fournit des méthodes supplémentaires que vous pouvez utiliser pour ouvrir ou fermer explicitement une connexion et pour vous 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. Vous pouvez éventuellement appeler Open() pour lancer manuellement une connexion de service avant de commencer la reconnaissance sur le module de reconnaissance associé à cette connexion. Après avoir démarré une reconnaissance, l’appel de 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 cas, les événements Connected/Disconnected indiquent la modification de la status de connexion.

Méthodes

Close()	Ferme la connexion au service. Vous pouvez éventuellement appeler Close() pour arrêter manuellement la connexion du module de reconnaissance associé. L’appel peut échouer, en fonction de l’état du processus du Module de reconnaissance. Toutefois, l’échec n’affecte pas l’état du module de reconnaissance associé.
Dispose()	Supprimer les ressources associées.
Finalize()	Classe proxy pour la gestion de la connexion au service speech du module De reconnaissance spécifié. Ajouté dans la version 1.2.0
FromConversationTranslator(ConversationTranslator)	Obtient le instance connexion du traducteur de conversation.
FromDialogServiceConnector(DialogServiceConnector)	Obtient le instance connexion à partir du connecteur de service de dialogue spécifié, utilisé pour observer et gérer la connexion et la déconnexion du service Speech.
FromRecognizer(Recognizer)	Obtient le instance de connexion à partir du module de reconnaissance spécifié.
FromSpeechSynthesizer(SpeechSynthesizer)	Obtient le instance de connexion à partir du synthétiseur vocal spécifié, utilisé pour observer et gérer la connexion et la déconnexion du service speech. Ajouté dans la version 1.17.0
Open(Boolean)	Commence à configurer la connexion au service. Vous pouvez éventuellement appeler Open() pour configurer manuellement une connexion à l’avance avant de commencer la reconnaissance sur le module de reconnaissance associé à cette connexion. Après avoir démarré la reconnaissance, l’appel d’Open() peut échouer, en fonction de l’état du processus du recognizer. Toutefois, l’échec n’affecte pas l’état du module de reconnaissance associé. Remarque : Au retour, la connexion n’est peut-être pas encore prête. Veuillez vous abonner à l’événement Connecté pour être averti lorsque la connexion est établie.
SendMessageAsync(String, Byte[], UInt32)	Envoie un message binaire au service speech en tant qu’opération asynchrone. Remarque : Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer. Ajouté dans 1.10.0
SendMessageAsync(String, String)	Envoie un message au service Speech en tant qu’opération asynchrone. Remarque : Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer. Ajouté dans la version 1.7.0
SetMessageProperty(String, String, String)	Ajoute un paramètre dans un message au service. Remarque : Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer. Ajouté dans la version 1.7.0

Événements

Connected	Événement Connected pour indiquer que le module de reconnaissance est connecté au service. Pour recevoir l’événement Connected après s’y être abonné, l’objet Connection lui-même doit être actif. Si l’objet Connection propriétaire de cet événement est hors de sa durée de vie, tous les événements abonnés ne sont pas remis.
Disconnected	Événement Disconnected pour indiquer que le module de reconnaissance est déconnecté du service. Pour recevoir l’événement Disconnected après s’y être abonné, l’objet Connection lui-même doit être actif. Si l’objet Connection propriétaire de cet événement est hors de sa durée de vie, tous les événements abonnés ne sont pas remis.
MessageReceived	L’événement MessageReceived indique que le service a envoyé un message réseau au client.