Partager via

connexion de classe

  • Article
class Connection
  : public std::enable_shared_from_this< Connection >

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 Open() 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 Open() ou Close() 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. Mise à jour dans la version 1.17.0.

Membres

Connecté

Syntaxe : public EventSignal< constConnectionEventArgs & > Connected;

Événement Connected pour indiquer que le module de reconnaissance est connecté au service.

Déconnecté

Syntaxe : public EventSignal< constConnectionEventArgs & > Disconnected;

Événement Déconnecté pour indiquer que le module de reconnaissance est déconnecté du service.

MessageReceived

Syntaxe : public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

Événement MessageReceived pour indiquer que le protocole sous-jacent a reçu un message du service. Ajout dans la version 1.10.0.

Ouvrir

Syntaxe : public inline void Open ( bool forContinuousRecognition );

Commence à configurer la connexion au service. Les utilisateurs peuvent éventuellement appeler Open() pour configurer manuellement une connexion à l’avance avant de démarrer la reconnaissance/synthèse sur le module de reconnaissance/synthétiseur 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/synthétiseur. Mais l’échec n’affecte pas l’état du recognizer/synthétiseur 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.

Paramètres

  • forContinuousRecognition Indique si la connexion est utilisée pour la reconnaissance continue ou la reconnaissance unique. Elle ne prend aucun effet si la connexion provient de SpeechSynthsizer.

Fermer

Syntaxe : public inline void Close ( );

Ferme la connexion au service. Les utilisateurs peuvent éventuellement appeler Close() pour arrêter manuellement la connexion du module de reconnaissance/synthétiseur associé. L’appel peut échouer, en fonction de l’état du processus du recognizer/synthétiseur. Mais l’échec n’affecte pas l’état du recognizer/synthétiseur associé.

SetMessageProperty

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

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

Paramètres

  • path chemin du message.

  • propertyName Nom de la propriété.

  • propertyValue Valeur de la propriété. Il s’agit d’une chaîne json.

Retours

Vide.

SendMessageAsync

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

Envoyez un message au service speech. Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer. Ajout dans la version 1.7.0.

Paramètres

  • path Chemin d’accès du message.

  • payload Charge utile du message. Il s’agit d’une chaîne json.

Retours

Un avenir vide.

SendMessageAsync

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

Envoyez un message binaire au service speech. Cette méthode ne fonctionne pas pour la connexion de SpeechSynthesizer. Ajout dans la version 1.10.0.

Paramètres

  • path Chemin d’accès du message.

  • payload Charge utile binaire du message.

  • size Taille de la charge utile binaire.

Retours

Un avenir vide.

Connexion

Syntaxe : public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Constructeur interne. Crée un instance à l’aide du handle fourni.

Paramètres

  • handle Handle de connexion.

~Connexion

Syntaxe : public inline ~Connection ( );

Destructeur.

FromRecognizer

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

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

Paramètres

  • recognizer Module de reconnaissance associé à la connexion.

Retours

Le instance de connexion du module de reconnaissance.

FromConversationTranslator

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

Obtient le instance de connexion à partir du traducteur de conversation spécifié.

Paramètres

  • convTrans Traducteur de conversation associé à la connexion.

Retours

Connexion instance du traducteur de conversation.

FromDialogServiceConnector

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

Obtient le instance de 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.

Paramètres

  • dialogServiceConnector Connecteur de service de dialogue associé à la connexion.

Retours

Le instance de connexion du connecteur de service de dialogue.

FromSpeechSynthesizer

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

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

Paramètres

  • synthesizer Synthétiseur vocal associé à la connexion.

Retours

Connexion instance du synthétiseur vocal.