Condividi tramite

classe Connection

  • Articolo
class Connection
  : public std::enable_shared_from_this< Connection >

La connessione è una classe proxy per la gestione della connessione al servizio voce del sistema di riconoscimento specificato. Per impostazione predefinita, un recognizer gestisce in modo autonomo la connessione al servizio quando necessario. La classe Connection fornisce metodi aggiuntivi per consentire agli utenti di aprire o chiudere in modo esplicito una connessione e di sottoscrivere le modifiche dello stato della connessione. L'uso di Connection è facoltativo. È destinato agli scenari in cui è necessaria l'ottimizzazione del comportamento dell'applicazione in base allo stato della connessione. Gli utenti possono facoltativamente chiamare Open() per avviare manualmente una connessione al servizio prima di avviare il riconoscimento nel sistema di riconoscimento associato a questa connessione. Dopo aver avviato un riconoscimento, la chiamata a Open() o Close() potrebbe non riuscire. Questo non influirà sul riconoscimento o sul riconoscimento in corso. La connessione potrebbe cadere per vari motivi, il sistema di riconoscimento tenterà sempre di reinstituire la connessione in base alle esigenze per garantire le operazioni in corso. In tutti questi casi gli eventi Connected/Disconnected indicherà la modifica dello stato della connessione. Aggiornato nella versione 1.17.0.

Membri

Connesso

Sintassi: public EventSignal< constConnectionEventArgs & > Connected;

Evento Connected per indicare che il riconoscitore è connesso al servizio.

Disconnesso

Sintassi: public EventSignal< constConnectionEventArgs & > Disconnected;

Evento Disconnected per indicare che il riconoscitore è disconnesso dal servizio.

MessageReceived

Sintassi: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

Evento MessageReceived per indicare che il protocollo sottostante ha ricevuto un messaggio dal servizio. Aggiunta nella versione 1.10.0.

Apri

Sintassi: public inline void Open ( bool forContinuousRecognition );

Avvia la configurazione della connessione al servizio. Gli utenti possono facoltativamente chiamare Open() per configurare manualmente una connessione in anticipo prima di avviare il riconoscimento/sintesi nel recognizer/sintetizzatore associato a questa connessione. Dopo l'avvio del riconoscimento, la chiamata a Open() potrebbe non riuscire, a seconda dello stato del processo di Riconoscimento/Sintetizzatore. Tuttavia, l'errore non influisce sullo stato del sistema di riconoscimento/sintetizzatore associato. Nota: al momento della restituzione, la connessione potrebbe non essere ancora pronta. Sottoscrivere l'evento Connected per ricevere una notifica quando viene stabilita la connessione.

Parametri

  • forContinuousRecognition Indica se la connessione viene utilizzata per il riconoscimento continuo o il riconoscimento singolo. Non ha effetto se la connessione proviene da SpeechSynthsizer.

Chiudi

Sintassi: public inline void Close ( );

Chiude la connessione al servizio. Gli utenti possono facoltativamente chiamare Close() per arrestare manualmente la connessione del sistema di riconoscimento/sintetizzatore associato. La chiamata potrebbe non riuscire, a seconda dello stato del processo di Recognizer/Synthesizer. Tuttavia, l'errore non influisce sullo stato del sistema di riconoscimento/sintetizzatore associato.

SetMessageProperty

Sintassi: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Aggiunge un parametro in un messaggio al servizio. Questo metodo non funziona per la connessione di SpeechSynthesizer. Aggiunta nella versione 1.7.0.

Parametri

  • path percorso del messaggio.

  • propertyName Nome della proprietà.

  • propertyValue Valore della proprietà . Si tratta di una stringa json.

Restituisce

Vuoto.

SendMessageAsync

Sintassi: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Inviare un messaggio al servizio di riconoscimento vocale. Questo metodo non funziona per la connessione di SpeechSynthesizer. Aggiunta nella versione 1.7.0.

Parametri

  • path Percorso del messaggio.

  • payload Payload del messaggio. Si tratta di una stringa json.

Restituisce

Un futuro vuoto.

SendMessageAsync

Sintassi: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Inviare un messaggio binario al servizio di riconoscimento vocale. Questo metodo non funziona per la connessione di SpeechSynthesizer. Aggiunta nella versione 1.10.0.

Parametri

  • path Percorso del messaggio.

  • payload Payload binario del messaggio.

  • size Dimensioni del payload binario.

Restituisce

Un futuro vuoto.

Connessione

Sintassi: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Costruttore interno. Crea una nuova istanza usando l'handle fornito.

Parametri

  • handle Handle di connessione.

~Connessione

Sintassi: public inline ~Connection ( );

Distruttore.

FromRecognizer

Sintassi: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Ottiene l'istanza di Connection dal riconoscitore specificato.

Parametri

  • recognizer Riconoscitore associato alla connessione.

Restituisce

Istanza connection del riconoscitore.

FromConversationTranslator

Sintassi: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Ottiene l'istanza di Connection dal traduttore di conversazioni specificato.

Parametri

  • convTrans Traduttore di conversazioni associato alla connessione.

Restituisce

Istanza connection del convertitore di conversazioni.

FromDialogServiceConnector

Sintassi: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Ottiene l'istanza di Connection dal connettore del servizio di dialogo specificato, utilizzata per osservare e gestire la connessione e la disconnessione dal servizio voce.

Parametri

  • dialogServiceConnector Connettore del servizio di dialogo associato alla connessione.

Restituisce

Istanza di Connection del connettore del servizio di dialogo.

FromSpeechSynthesizer

Sintassi: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Ottiene l'istanza connection dal sintetizzatore vocale specificato. Aggiunta nella versione 1.17.0.

Parametri

  • synthesizer Sintetizzatore vocale associato alla connessione.

Restituisce

Istanza connection del sintetizzatore vocale.