Connexion de classe

class Connection
  : public std::enable_shared_from_this< Connection >

La connexion est une classe proxy pour la gestion de la connexion au service speech du module Recognizer spécifié. Par défaut, un Recognizer gère de manière autonome la connexion au service si nécessaire. La classe Connection fournit des méthodes supplémentaires pour permettre aux utilisateurs d’ouvrir ou de fermer explicitement une connexion et de s’abonner aux modifications d’état de connexion. L’utilisation de la connexion est facultative. Il est destiné aux scénarios où le réglage précis du comportement de l’application en fonction de l’état de la connexion est nécessaire. Les utilisateurs peuvent éventuellement appeler Open() pour lancer manuellement une connexion de service avant de commencer la reconnaissance sur le module Recognizer associé à cette connexion. Après avoir démarré une reconnaissance, l’appel d’Open() ou Close() peut échouer. Cela n’aura pas d’impact sur le module Recognizer ou la reconnaissance en cours. La connexion peut tomber pour différentes raisons, le module Recognizer essaie toujours de rétablir la connexion selon les besoins pour garantir les opérations en cours. Dans tous ces cas, les événements connectés/déconnectés indiquent la modification de l’état de la connexion. Mise à jour dans la version 1.17.0.

Membres

Connecté

Syntaxe : public EventSignal< const ConnectionEventArgs & > Connected;

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

Déconnecté

Syntaxe : public EventSignal< const ConnectionEventArgs & > Disconnected;

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

MessageReceived

Syntaxe : public EventSignal< const ConnectionMessageEventArgs & > 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 commencer la reconnaissance/synthèse sur le module Recognizer/Synthesisr associé à cette connexion. Après avoir démarré la reconnaissance, l’appel d’Open() peut échouer, en fonction de l’état du processus du module Recognizer/Synthesizer. Toutefois, l’échec n’affecte pas l’état du module Recognizer/Synther associé. Remarque : Lors du 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.

Paramètres

• forContinuousRecognition Indique si la connexion est utilisée pour la reconnaissance continue ou la reconnaissance unique. Elle n’a 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 Recognizer/Synthesizer associé. L’appel peut échouer, en fonction de l’état du processus du module Recognizer/Synther. Toutefois, l’échec n’affecte pas l’état du module Recognizer/Synther 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. Ajouté dans la version 1.7.0.

Paramètres

• path le 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. Ajouté dans la version 1.7.0.

Paramètres

• path Chemin d’accès du message.

• payload La 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 La taille de la charge utile binaire.

Retours

Un avenir vide.

Connexion

Syntaxe : public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

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

Paramètres

• handle Le 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 l’instance de connexion à partir du module de reconnaissance spécifié.

Paramètres

• recognizer Le module de reconnaissance associé à la connexion.

Retours

Instance de connexion du module de reconnaissance.

FromConversationTranslator

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

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

Paramètres

• convTrans Le traducteur de conversation associé à la connexion.

Retours

Instance de connexion du traducteur de conversation.

FromDialogServiceConnector

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

Obtient l’instance de connexion à partir du connecteur de service de dialogue spécifié, utilisée pour observer et gérer la connexion et la déconnexion du service speech.

Paramètres

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

Retours

Instance de connexion du connecteur de service de boîte de dialogue.

FromSpeechSynthesizer

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

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

Paramètres

• synthesizer Le synthétiseur vocal associé à la connexion.

Retours

Instance de connexion du synthétiseur vocal.