DialogServiceConnector Classe

Stabilisce in modo sincrono una connessione con il servizio. La connessione viene eseguita automaticamente quando necessario, ma questa chiamata manuale può essere utile per assicurarsi che la connessione sia attiva prima del primo uso per ridurre la latenza iniziale.

In caso contrario, la connessione potrebbe non essere ancora pronta. Sottoscrivere l'evento connesso dell'istanza di connessione per ricevere una notifica quando viene stabilita la connessione al servizio. Usare Connection per recuperare l'istanza usando from_dialog_service_connector il metodo .

connect()

Stabilisce in modo asincrono una connessione con il servizio. La connessione viene eseguita automaticamente quando necessario, ma questa chiamata manuale può essere utile per assicurarsi che la connessione sia attiva prima del primo uso per ridurre la latenza iniziale.

connect_async()

Restituisce

Disconnette in modo sincrono dal servizio. Le chiamate successive che richiedono una connessione continueranno a riconnettersi automaticamente dopo la disconnessione manuale.

disconnect()

Disconnette in modo asincrono dal servizio. Le chiamate successive che richiedono una connessione continueranno a riconnettersi automaticamente dopo la disconnessione manuale.

disconnect_async()

Restituisce

Avvia in modo sincrono un'interazione voce-a-testo con questo connettore e blocca fino a quando non viene ricevuto un singolo risultato finale voce-a-testo. Il risultato voce-a-testo ricevuto viene fornito anche all'implementazione del dialogo configurata e che il sistema di dialogo può produrre qualsiasi numero di payload attività in risposta all'interazione vocale. Le interazioni vocali possono essere correlate alle attività tramite dati specifici del dialogo nel payload dell'attività.

listen_once() -> SpeechRecognitionResult

Restituisce

Avvia in modo asincrono un'interazione voce-a-testo con questo connettore e blocca fino a quando non viene ricevuto un singolo risultato finale voce-to-text. Il risultato voce-a-testo ricevuto viene fornito anche all'implementazione del dialogo configurata e che il sistema di dialogo può produrre qualsiasi numero di payload attività in risposta all'interazione vocale. Le interazioni vocali possono essere correlate alle attività tramite dati specifici del dialogo nel payload dell'attività.

listen_once_async() -> ResultFuture

Restituisce

Invia in modo sincrono un payload di dati al servizio back-end della finestra di dialogo a cui è connessa l'istanza di DialogServiceConnector. Questo è in genere un documento JSON con il relativo schema determinato dall'implementazione del dialogo nel servizio e il contenuto di un'attività inviata deve essere popolato con conoscenza del formato e delle aspettative del contenuto del sistema di dialogo. Le attività inviate non sono associate ad altre interazioni e genereranno il proprio identificatore di interazione autonoma quando elaborato dal servizio. La correlazione delle conversazioni e di altre interazioni deve essere eseguita tramite il payload dell'attività stessa usando le funzionalità dell'implementazione del dialogo usata.

send_activity(activity: str) -> str

Parametri

Restituisce

Invia in modo asincrono un'attività al dialogo di backup, vedere i dettagli della descrizione all'indirizzo send_activity

send_activity_async(activity: str) -> ResultFuture

Parametri

Restituisce

Avvia in modo sincrono un'interazione vocale a testo con questo connettore usando una parola chiave. Questa interazione userà il modello di parola chiave fornito per ascoltare una parola chiave indefinita, durante la quale l'audio non viene inviato al servizio voce e tutte le elaborazioni vengono eseguite in locale. Quando viene riconosciuta una parola chiave, DialogServiceConnector si connetterà automaticamente al servizio voce e inizierà a inviare dati audio da appena prima della parola chiave come se listen_once_async fosse stato richiamato. Quando ricevuti, i risultati del riconoscimento vocale possono essere elaborati dal gestore dei risultati specificato o recuperati tramite una sottoscrizione all'evento riconosciuto. Il risultato voce-a-testo prodotto da questa operazione viene fornito anche all'implementazione del dialogo configurata e che il sistema di dialogo può produrre qualsiasi numero di payload attività in risposta all'interazione vocale. Le interazioni vocali possono essere correlate alle attività tramite dati specifici del dialogo nel payload dell'attività.

Chiamare stop_keyword_recognition_async per arrestare il riconoscimento avviato dalla parola chiave.

start_keyword_recognition(model: KeywordRecognitionModel)

Parametri

Configura in modo asincrono il connettore del servizio di dialogo con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il connettore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition_async per arrestare il riconoscimento avviato dalla parola chiave.

Vedere start_keyword_recognition per una descrizione dettagliata della funzionalità.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parametri

Restituisce

Si arresta in modo sincrono il riconoscimento avviato dalla parola chiave.

stop_keyword_recognition()

Arresta in modo asincrono il riconoscimento avviato dalla parola chiave.

stop_keyword_recognition_async()

Restituisce

Richiede un arresto immediato a qualsiasi operazione di ascolto attiva. Ciò può interrompere un'interazione voce-a-testo in corso e qualsiasi risultato vocale ricevuto può rappresentare un input vocale incompleto.

I metodi sincroni non devono essere chiamati durante la gestione di un evento. Usare stop_listening_async se un arresto è desiderato in risposta a un evento.

stop_listening()

Restituisce

Richiede un arresto immediato a qualsiasi operazione di ascolto attiva. Ciò può interrompere un'interazione voce-a-testo in corso e qualsiasi risultato vocale ricevuto può rappresentare un input vocale incompleto.

stop_listening_async()

Restituisce

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

I callback connessi a questo segnale vengono chiamati con un'istanza ActivityReceivedEventArgsdi , come singolo argomento, dipendente dal tipo di riconoscimento.

Token di autorizzazione che verrà usato per la connessione al servizio.

Segnale per gli eventi contenenti risultati di riconoscimento annullati (che indica un tentativo di riconoscimento annullato come risultato o una richiesta di annullamento diretta o, in alternativa, un errore di trasporto o protocollo).

I callback connessi a questo segnale vengono chiamati con un'istanza SpeechRecognitionCanceledEventArgsdi , come singolo argomento.

Segnale per gli eventi contenenti risultati di riconoscimento finale (che indica un tentativo di riconoscimento riuscito).

I callback connessi a questo segnale vengono chiamati con un'istanza SpeechRecognitionEventArgsdi , come singolo argomento, dipendente dal tipo di riconoscimento.

Segnale per gli eventi contenenti risultati di riconoscimento intermedio.

I callback connessi a questo segnale vengono chiamati con un'istanza SpeechRecognitionEventArgsdi , come singolo argomento.

Segnale per gli eventi che indicano l'inizio di una sessione di riconoscimento (operazione).

I callback connessi a questo segnale vengono chiamati con un'istanza SessionEventArgs come singolo argomento.

Segnale per gli eventi che indicano la fine di una sessione di riconoscimento (operazione).

I callback connessi a questo segnale vengono chiamati con un'istanza SessionEventArgs come singolo argomento.

Ottiene il modello JSON che verrà fornito al servizio voce per la conversazione successiva. Il servizio tenterà di unire questo modello in tutte le attività inviate al back-end della finestra di dialogo, indipendentemente dall'origine dal client con SendActivityAsync o generato dal servizio, come accade con i risultati voce-a-testo.

Segnale per gli eventi che indicano la fine della voce.

I callback connessi a questo segnale vengono chiamati con un'istanza RecognitionEventArgs come singolo argomento.

Segnale per gli eventi che indicano l'inizio della voce.

I callback connessi a questo segnale vengono chiamati con un'istanza RecognitionEventArgs come singolo argomento.

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

I callback connessi a questo segnale vengono chiamati con un'istanza TurnStatusReceivedEventArgsdi , come singolo argomento.