Connection Classe

Paquet:

com.microsoft.cognitiveservices.speech

Artefact Maven:

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

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

Implémente

java.lang.AutoCloseable

public final class Connection
implements java.lang.AutoCloseable

La connexion est une classe proxy permettant de gérer la connexion au service speech du recognizer spécifié. Par défaut, un recognizer gère de manière autonome la connexion au service en cas de besoin. La classe Connection fournit des méthodes supplémentaires permettant aux utilisateurs d’ouvrir ou de fermer explicitement une connexion et de s’abonner à la connexion status modifications. L’utilisation de Connexion est facultative. Il est destiné aux scénarios dans lesquels un réglage précis du comportement de l’application en fonction de la status de connexion est nécessaire. Les utilisateurs peuvent éventuellement appeler openConnection() pour lancer manuellement une connexion de service avant de démarrer la reconnaissance sur le recognizer associé à cette connexion. Après avoir démarré une reconnaissance, l’appel de openConnection() ou closeConnection() peut échouer. Cela n’aura pas d’impact sur le recognizer ou la reconnaissance en cours. La connexion peut tomber pour différentes raisons. Le recognizer essaiera toujours de rétablir la connexion en fonction des besoins pour garantir les opérations en cours. Dans tous ces cas, les événements connectés/déconnectés indiquent la modification de la status de connexion. Remarque : close() doit être appelé pour libérer les ressources sous-jacentes détenues par l’objet. Mise à jour dans la version 1.17.0.

Récapitulatif du champ

Modificateur et type	Champ et description
final EventHandlerImpl<ConnectionEventArgs>	connected Événement Connected pour indiquer que le module de reconnaissance est connecté au service.
final EventHandlerImpl<ConnectionEventArgs>	disconnected Événement Déconnecté pour indiquer que le module de reconnaissance est déconnecté du service.
final EventHandlerImpl<ConnectionMessageEventArgs>	messageReceived L’événement Messagereçu indique que le service a envoyé un message réseau au client.

Résumé de la méthode

Modificateur et type	Méthode et description
void	close() Supprimer les ressources associées.
void	closeConnection() Ferme la connexion au service.
static Connection	fromConversationTranslator(ConversationTranslator conversationTranslator) Obtient le instance de connexion du traducteur de conversation.
static Connection	fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector) Obtient le instance de connexion à partir du connecteur de service de boîte de dialogue.
static Connection	fromRecognizer(Recognizer recognizer) Obtient le instance de connexion à partir du module de reconnaissance spécifié.
static Connection	fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer) Obtient le instance de connexion à partir du synthétiseur vocal.
void	openConnection(boolean forContinuousRecognition) Commence à configurer la connexion au service.
java.util.concurrent.Future<java.lang.Void>	sendMessageAsync(String path, String payload) Envoie un message au service.
void	setMessageProperty(String path, String propertyName, String propertyValue) Ajoute un paramètre dans un message au service.

Méthodes héritées 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

Détails du champ

connected

public final EventHandlerImpl connected

Événement Connected pour indiquer que le module de reconnaissance est connecté au service. Pour recevoir l’événement connecté 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 seront pas remis.

disconnected

public final EventHandlerImpl disconnected

Événement Déconnecté pour indiquer que le module de reconnaissance est déconnecté du service. Pour recevoir l’événement déconnecté 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 seront pas remis.

messageReceived

public final EventHandlerImpl messageReceived

L’événement MessageReceived indique que le service a envoyé un message réseau au client. Ajout dans la version 1.15.0.

Détails de la méthode

close

public void close()

Supprimer les ressources associées. close() doit être appelé pour abandonner correctement les ressources sous-jacentes.

closeConnection

public void closeConnection()

Ferme la connexion au service. Les utilisateurs peuvent éventuellement appeler closeConnection() pour arrêter manuellement la connexion du recognizer associé. L’appel peut échouer, en fonction de l’état du processus du Recognizer. Toutefois, l’échec n’affecte pas l’état du recognizer associé.

fromConversationTranslator

public static Connection fromConversationTranslator(ConversationTranslator conversationTranslator)

Obtient le instance de connexion du traducteur de conversation.

Parameters:

conversationTranslator - ConversationTranslator associé à la connexion.

Returns:

Le instance de connexion du module de reconnaissance.

fromDialogServiceConnector

public static Connection fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector)

Obtient le instance de connexion à partir du connecteur de service de boîte de dialogue.

Parameters:

dialogServiceConnector - Connecteur de service de dialogue associé à la connexion, utilisé pour observer et gérer l’état de la connexion avec le service speech.

Returns:

Le instance de connexion du connecteur de service de dialogue.

fromRecognizer

public static Connection fromRecognizer(Recognizer recognizer)

Obtient le instance de connexion à partir du module de reconnaissance spécifié.

Parameters:

recognizer - Module de reconnaissance associé à la connexion.

Returns:

Le instance de connexion du module de reconnaissance.

fromSpeechSynthesizer

public static Connection fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer)

Obtient le instance de connexion à partir du synthétiseur vocal. Ajouté dans la version 1.17.0

Parameters:

speechSynthesizer - Synthétiseur vocal associé à la connexion, utilisé pour observer et gérer l’état de connexion avec le service speech.

Returns:

Connexion instance du synthétiseur vocal.

openConnection

public void openConnection(boolean forContinuousRecognition)

Commence à configurer la connexion au service. Les utilisateurs peuvent éventuellement appeler openConnection() pour configurer manuellement une connexion à l’avance avant de commencer la reconnaissance sur le recognizer associé à cette connexion. Après avoir démarré la reconnaissance, l’appel d’OpenConnection() peut échouer, en fonction de l’état du processus du Recognizer. Toutefois, l’échec n’affecte pas l’état du recognizer associé. Remarque : Au retour, la connexion n’est peut-être pas encore prête. Abonnez-vous à l’événement Connecté pour être averti lorsque la connexion est établie.

Parameters:

forContinuousRecognition - indique si la connexion est utilisée pour la reconnaissance continue ou la reconnaissance d’un seul coup. Elle ne prend aucun effet si la connexion provient de SpeechSynthsizer.

sendMessageAsync

public Future sendMessageAsync(String path, String payload)

Envoie un message au service. Ajoutée dans la version 1.7.0 Remarque : cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer.

Parameters:

path - Chemin d’accès du message.

payload - Charge utile de message.

Returns:

un futur représentant l’opération asynchrone qui envoie le message.

setMessageProperty

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

Ajoute un paramètre dans un message au service. Ajoutée dans la version 1.7.0 Remarque : cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer.

Parameters:

path - Chemin d’accès du message.

propertyName - Nom de propriété que vous souhaitez définir.

propertyValue - Valeur de la propriété que vous souhaitez définir.