Classe Dialog::D ialogServiceConnector

  • Articolo
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

Recognized

Sintassi: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

Segnalare gli eventi contenenti i risultati del riconoscimento vocale.

Riconoscere

Sintassi: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

Segnalare gli eventi contenenti risultati intermedi del riconoscimento.

SessionStarted

Sintassi: public EventSignal< constSessionEventArgs & > SessionStarted;

Segnala che indica l'inizio di una sessione di ascolto.

SessionStopped

Sintassi: public EventSignal< constSessionEventArgs & > SessionStopped;

Segnale che indica la fine di una sessione di ascolto.

SpeechStartDetected

Sintassi: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

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

SpeechEndDetected

Sintassi: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

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

Cancellati

Sintassi: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

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

ActivityReceived

Sintassi: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

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

TurnStatusReceived

Sintassi: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

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

Proprietà

Sintassi: public PropertyCollection & Properties;

Raccolta di proprietà e 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 con il back-end.

Restituisce

Operazione asincrona che avvia la connessione.

DisconnectAsync

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

Si disconnette dal back-end.

Restituisce

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

  • activity Attività da inviare

Restituisce

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 parole chiave da utilizzare.

Restituisce

Operazione asincrona che avvia l'operazione.

StopKeywordRecognitionAsync

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

Arrestare il riconoscimento delle parole chiave.

Restituisce

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.

Restituisce

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.

Restituisce

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.

Restituisce

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 accade con i risultati della sintesi vocale.

Parametri

  • activityTemplate 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 accade con i risultati della sintesi vocale.

Restituisce

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 dialogServiceConfig e audio::AudioConfig. Gli utenti devono usare questa funzione per creare un connettore di servizi di dialogo.

Parametri

  • connectorConfig Configurazione del servizio dialog.

  • audioConfig Configurazione audio.

Restituisce

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: