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 di riconoscimento vocale specificato. Per impostazione predefinita, un Sistema di riconoscimento gestisce in modo autonomo la connessione al servizio quando necessario. La classe Connection fornisce metodi aggiuntivi per consentire agli utenti di aprire o chiudere una connessione in modo esplicito 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 l'avvio di un riconoscimento, la chiamata a Open() o Close() potrebbe non riuscire. Ciò 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< const ConnectionEventArgs & > Connected;

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

Sconnesso

Sintassi: public EventSignal< const ConnectionEventArgs & > Disconnected;

Evento Disconnected per indicare che il sistema di riconoscimento è disconnesso dal servizio.

MessageReceived

Sintassi: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

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

Aperto

Sintassi: public inline void Open ( bool forContinuousRecognition );

Avvia la configurazione della connessione al servizio. Facoltativamente, gli utenti possono 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 riconoscimento/sintetizzatore associato. Nota: in caso di 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 usata per il riconoscimento continuo o il riconoscimento con registrazione singola. 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 Riconoscimento/Sintetizzatore. Tuttavia, l'errore non influisce sullo stato del 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. Aggiunta nella versione 1.7.0.

Parametri

  • path il percorso del messaggio.

  • propertyName Nome della proprietà.

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

Restituzioni

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. Aggiunta nella versione 1.7.0.

Parametri

  • path Percorso del messaggio.

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

Restituzioni

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.

Restituzioni

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 sistema di riconoscimento specificato.

Parametri

  • recognizer Il riconoscitore associato alla connessione.

Restituzioni

Istanza connection del sistema di riconoscimento.

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 Il traduttore di conversazioni associato alla connessione.

Restituzioni

Istanza di 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 di riconoscimento vocale.

Parametri

  • dialogServiceConnector Connettore del servizio di dialogo associato alla connessione.

Restituzioni

Istanza 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 di Connection dal sintetizzatore vocale specificato. Aggiunta nella versione 1.17.0.

Parametri

  • synthesizer Il sintetizzatore vocale associato alla connessione.

Restituzioni

Istanza di Connection del sintetizzatore vocale.