classe Dialog ::D ialogServiceConnector
class Dialog::DialogServiceConnector
: public std::enable_shared_from_this< DialogServiceConnector >
: public Utils::NonCopyable
: public Utils::NonMovable
Objet utilisé pour connecter DirectLineSpeech ou CustomCommands.
Les objets de ce type sont créés via la méthode de fabrique FromConfig .
Membres
Reconnu
Syntaxe : public EventSignal< constSpeechRecognitionEventArgs & > Recognized;
Signal pour les événements contenant les résultats de la reconnaissance vocale.
Reconnaissant
Syntaxe : public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;
Signal pour les événements contenant des résultats de reconnaissance intermédiaires.
SessionStarted
Syntaxe : public EventSignal< constSessionEventArgs & > SessionStarted;
Signaux qui indiquent le début d’une session d’écoute.
SessionStopped
Syntaxe : public EventSignal< constSessionEventArgs & > SessionStopped;
Signal qui indique la fin d’une session d’écoute.
SpeechStartDetected
Syntaxe : public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;
Signal qui indique la première détection des données vocales dans l’expression actuelle.
SpeechEndDetected
Syntaxe : public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;
Signal qui indique la fin détectée des données vocales de l’expression actuelle.
Opération annulée
Syntaxe : public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;
Signal pour les événements liés à l’annulation d’une interaction. L’événement indique si la raison est une annulation directe ou une erreur.
ActivityReceived
Syntaxe : public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;
Signale qu’une activité a été reçue du back-end.
TurnStatusReceived
Syntaxe : public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;
Signale qu’un tour status mise à jour a été reçu du back-end.
Propriétés
Syntaxe : public PropertyCollection & Properties;
Collection de propriétés et leurs valeurs définies pour ce DialogServiceConnector.
~DialogServiceConnector
Syntaxe : public inline virtual ~DialogServiceConnector ( );
Détruit le instance.
ConnectAsync
Syntaxe : public inline std::future< void > ConnectAsync ( );
Se connecte au serveur principal.
Retours
Opération asynchrone qui démarre la connexion.
DisconnectAsync
Syntaxe : public inline std::future< void > DisconnectAsync ( );
Se déconnecte du back-end.
Retours
Opération asynchrone qui démarre la déconnexion.
SendActivityAsync
Syntaxe : public inline std::future< std::string > SendActivityAsync ( const std::string & activity );
Envoie une activité à la boîte de dialogue de sauvegarde.
Paramètres
activity
Activité à envoyer
Retours
Opération asynchrone qui démarre l’opération.
StartKeywordRecognitionAsync
Syntaxe : public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );
Lance la reconnaissance mot clé.
Paramètres
model
Spécifie le modèle mot clé à utiliser.
Retours
Opération asynchrone qui démarre l’opération.
StopKeywordRecognitionAsync
Syntaxe : public inline std::future< void > StopKeywordRecognitionAsync ( );
Arrêtez mot clé reconnaissance.
Retours
Opération asynchrone qui démarre l’opération.
ListenOnceAsync
Syntaxe : public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );
Démarre une session d’écoute qui se terminera après le premier énoncé.
Retours
Opération asynchrone qui démarre l’opération.
StopListeningAsync
Syntaxe : public inline std::future< void > StopListeningAsync ( );
Demande qu’une opération d’écoute active se termine immédiatement, interrompant toute conversation en cours et fournissant un résultat reflétant toutes les données audio capturées jusqu’à présent.
Retours
Tâche représentant l’opération asynchrone qui arrête une session d’écoute active.
SetAuthorizationToken
Syntaxe : public inline void SetAuthorizationToken ( const std::string & token );
Définit le jeton d’autorisation qui sera utilisé pour la connexion au service. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode setter avec un nouveau jeton valide. Dans le cas contraire, le connecteur rencontrera des erreurs pendant son fonctionnement.
Paramètres
token
Jeton d’autorisation.
GetAuthorizationToken
Syntaxe : public inline std::string GetAuthorizationToken ( );
Obtient le jeton d’autorisation.
Retours
Jeton d’autorisation
SetSpeechActivityTemplate
Syntaxe : public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );
Définit un modèle JSON qui sera fourni au service speech pour la conversation suivante. Le service tente de fusionner ce modèle dans toutes les activités envoyées au back-end de dialogue, qu’elles proviennent du client avec SendActivityAsync ou qu’elles soient générées par le service, comme c’est le cas pour les résultats de reconnaissance vocale.
Paramètres
activityTemplate
Charge utile de l’activité, sous forme de chaîne JSON, à fusionner dans tous les messages d’activité applicables.
GetSpeechActivityTemplate
Syntaxe : public inline std::string GetSpeechActivityTemplate ( );
Obtient le modèle JSON qui sera fourni au service speech pour la conversation suivante. Le service tente de fusionner ce modèle dans toutes les activités envoyées au back-end de dialogue, qu’elles proviennent du client avec SendActivityAsync ou générées par le service, comme c’est le cas avec les résultats de reconnaissance vocale.
Retours
Modèle d’activité JSON actuellement défini qui sera utilisé sur les demandes suivantes.
FromConfig
Syntaxe : public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );
Crée un connecteur de service de dialogue à partir d’un DialogServiceConfig et d’un Audio ::AudioConfig. Les utilisateurs doivent utiliser cette fonction pour créer un connecteur de service de dialogue.
Paramètres
connectorConfig
Configuration du service de dialogue.audioConfig
Configuration audio.
Retours
Pointeur intelligent partagé du connecteur de service de dialogue créé.
auto audioConfig = [Audio::AudioConfig::FromDefaultMicrophoneInput](audio-audioconfig.md#fromdefaultmicrophoneinput)();
auto config = [CustomCommandsConfig::FromAuthorizationToken](dialog-customcommandsconfig.md#fromauthorizationtoken)("my_app_id","my_auth_token", "my_region");
auto connector = [DialogServiceConnector::FromConfig](#fromconfig)(config, audioConfig);
Lorsque vous parlez de DialogServiceConfig , nous faisons référence à l’une des classes qui héritent de celle-ci. La classe spécifique à utiliser dépend du back-end de dialogue utilisé :
BotFrameworkConfig pour DirectLineSpeech
CustomCommandsConfig pour CustomCommands