class 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

Constaté

Syntaxe : public EventSignal< const SpeechRecognitionEventArgs & > Recognized;

Signal pour les événements contenant des résultats de reconnaissance vocale.

Reconnaissant

Syntaxe : public EventSignal< const SpeechRecognitionEventArgs & > Recognizing;

Signal pour les événements contenant des résultats de reconnaissance intermédiaire.

SessionStarted

Syntaxe : public EventSignal< const SessionEventArgs & > SessionStarted;

Signaux qui indiquent le début d’une session d’écoute.

SessionStopped

Syntaxe : public EventSignal< const SessionEventArgs & > SessionStopped;

Signal qui indique la fin d’une session d’écoute.

SpeechStartDetected

Syntaxe : public EventSignal< const RecognitionEventArgs & > SpeechStartDetected;

Signal qui indique la première détection des données vocales dans l’expression actuelle.

SpeechEndDetected

Syntaxe : public EventSignal< const RecognitionEventArgs & > SpeechEndDetected;

Signal indiquant la fin détectée des données vocales de l’expression actuelle.

Annulé

Syntaxe : public EventSignal< const SpeechRecognitionCanceledEventArgs & > 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< const ActivityReceivedEventArgs & > ActivityReceived;

Signale qu’une activité a été reçue du serveur principal.

TurnStatusReceived

Syntaxe : public EventSignal< const TurnStatusReceivedEventArgs & > TurnStatusReceived;

Signale qu’une mise à jour d’état de tour a été reçue du serveur principal.

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 l’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 stockage.

Paramètres

  • activité activity à 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 de mot clé.

Paramètres

  • model Spécifie le modèle de mot clé à utiliser.

Retours

Opération asynchrone qui démarre l’opération.

StopKeywordRecognitionAsync

Syntaxe : public inline std::future< void > StopKeywordRecognitionAsync ( );

Arrêter la reconnaissance de mot clé.

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 termine 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, interrompt toute parole en cours et fournit un résultat reflétant 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 l’expiration du jeton d’autorisation, l’appelant doit l’actualiser en appelant ce setter avec un nouveau jeton valide. Sinon, le connecteur rencontre des erreurs pendant son opération.

Paramètres

  • token Le 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’il provient du client avec SendActivityAsync ou généré par le service, comme c’est le cas avec les résultats de la reconnaissance vocale.

Paramètres

  • activityTemplate La charge utile d’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’il provient du client avec SendActivityAsync ou généré par le service, comme c’est le cas avec les résultats de la reconnaissance vocale.

Retours

Le 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.

  • configuration audio audioConfig.

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 serveur principal de dialogue utilisé :