Classe Dialog::D ialogServiceConnector

class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

Oggetto utilizzato per connettere DirectLineSpeech o CustomCommands.

Gli oggetti di questo tipo vengono creati tramite il metodo factory FromConfig.

Membri

Riconosciuto

Sintassi: public EventSignal< const SpeechRecognitionEventArgs & > Recognized;

Segnale per gli eventi contenenti i risultati del riconoscimento vocale.

Riconoscere

Sintassi: public EventSignal< const SpeechRecognitionEventArgs & > Recognizing;

Segnale per gli eventi contenenti risultati intermedi del riconoscimento.

SessionStarted

Sintassi: public EventSignal< const SessionEventArgs & > SessionStarted;

Segnali che indicano l'inizio di una sessione di ascolto.

SessionStopped

Sintassi: public EventSignal< const SessionEventArgs & > SessionStopped;

Segnale che indica la fine di una sessione di ascolto.

SpeechStartDetected

Sintassi: public EventSignal< const RecognitionEventArgs & > SpeechStartDetected;

Segnale che indica il primo rilevamento dei dati vocali nella frase corrente.

SpeechEndDetected

Sintassi: public EventSignal< const RecognitionEventArgs & > SpeechEndDetected;

Segnale che indica la fine rilevata dei dati vocali della frase corrente.

Annullato

Sintassi: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Segnale per gli eventi relativi all'annullamento di un'interazione. L'evento indica se il motivo è un annullamento diretto o un errore.

ActivityReceived

Sintassi: public EventSignal< const ActivityReceivedEventArgs & > ActivityReceived;

Segnala che un'attività è stata ricevuta dal back-end.

TurnStatusReceived

Sintassi: public EventSignal< const TurnStatusReceivedEventArgs & > TurnStatusReceived;

Segnala che un aggiornamento dello stato del turno è stato ricevuto dal back-end.

Proprietà

Sintassi: public PropertyCollection & Properties;

Raccolta di proprietà e dei relativi valori definiti per questo DialogServiceConnector.

~DialogServiceConnector

Sintassi: public inline virtual ~DialogServiceConnector ( );

Elimina definitivamente l'istanza.

ConnectAsync

Sintassi: public inline std::future< void > ConnectAsync ( );

Si connette al back-end.

Restituzioni

Operazione asincrona che avvia la connessione.

DisconnectAsync

Sintassi: public inline std::future< void > DisconnectAsync ( );

Si disconnette dal back-end.

Restituzioni

Operazione asincrona che avvia la disconnessione.

SendActivityAsync

Sintassi: public inline std::future< std::string > SendActivityAsync ( const std::string & activity );

Invia un'attività al dialogo di backup.

Parametri

  • attività activity da inviare

Restituzioni

Operazione asincrona che avvia l'operazione.

StartKeywordRecognitionAsync

Sintassi: public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Avvia il riconoscimento delle parole chiave.

Parametri

  • model Specifica il modello di parola chiave da usare.

Restituzioni

Operazione asincrona che avvia l'operazione.

StopKeywordRecognitionAsync

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

Arrestare il riconoscimento delle parole chiave.

Restituzioni

Operazione asincrona che avvia l'operazione.

ListenOnceAsync

Sintassi: public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );

Avvia una sessione di ascolto che terminerà dopo la prima espressione.

Restituzioni

Operazione asincrona che avvia l'operazione.

StopListeningAsync

Sintassi: public inline std::future< void > StopListeningAsync ( );

Richiede che un'operazione di ascolto attiva termini immediatamente, interrompa qualsiasi parlato in corso e fornisca un risultato che rifletta i dati audio acquisiti finora.

Restituzioni

Attività che rappresenta l'operazione asincrona che arresta una sessione di ascolto attiva.

SetAuthorizationToken

Sintassi: public inline void SetAuthorizationToken ( const std::string & token );

Imposta il token di autorizzazione che verrà usato per la connessione al servizio. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido. In caso contrario, il connettore rileva errori durante l'operazione.

Parametri

  • token Token di autorizzazione.

GetAuthorizationToken

Sintassi: public inline std::string GetAuthorizationToken ( );

Ottiene il token di autorizzazione.

Restituzioni

Token di autorizzazione

SetSpeechActivityTemplate

Sintassi: public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );

Imposta un modello JSON che verrà fornito al servizio di riconoscimento vocale per la conversazione successiva. Il servizio tenterà di unire questo modello in tutte le attività inviate al back-end della finestra di dialogo, indipendentemente dal fatto che il client abbia origine con SendActivityAsync o generato dal servizio, come nel caso dei risultati della sintesi vocale.

Parametri

  • activityTemplate Il payload dell'attività, come stringa JSON, da unire in tutti i messaggi di attività applicabili.

GetSpeechActivityTemplate

Sintassi: public inline std::string GetSpeechActivityTemplate ( );

Ottiene il modello JSON che verrà fornito al servizio di riconoscimento vocale per la conversazione successiva. Il servizio tenterà di unire questo modello in tutte le attività inviate al back-end della finestra di dialogo, indipendentemente dal fatto che il client abbia origine con SendActivityAsync o generato dal servizio, come nel caso dei risultati della sintesi vocale.

Restituzioni

Il modello di attività JSON attualmente impostato che verrà usato nelle richieste successive.

FromConfig

Sintassi: public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );

Crea un connettore del servizio di dialogo da un DialogServiceConfig e da un Audio::AudioConfig. Gli utenti devono usare questa funzione per creare un connettore del servizio di dialogo.

Parametri

  • connectorConfig configurazione del servizio Dialog.

  • audioConfig configurazione audio.

Restituzioni

Puntatore intelligente condiviso del connettore del servizio di dialogo creato.

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);

Quando si parla di DialogServiceConfig si fa riferimento a una delle classi che ereditano da essa. La classe specifica da usare dipende dal back-end del dialogo usato:

  • BotFrameworkConfig per DirectLineSpeech

  • CustomCommandsConfig per CustomCommands