Partager via


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

  • modelSpé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é :