Connection Classe

Classe proxy per la gestione della connessione al servizio voce dell'oggetto specificato Recognizer.

Per impostazione predefinita, un servizio Recognizer gestisce autonomamente la connessione al servizio quando necessario. La Connection classe fornisce metodi aggiuntivi per gli utenti per aprire o chiudere in modo esplicito una connessione e sottoscrivere le modifiche dello stato della connessione. L'uso di Connection è facoltativo. È destinato agli scenari in cui è necessario ottimizzare il comportamento dell'applicazione in base allo stato di connessione. Gli utenti possono chiamare open facoltativamente per avviare manualmente una connessione al servizio prima di avviare il riconoscimento nell'oggetto Recognizer associato a .Connection Dopo aver avviato un riconoscimento, chiamare open o close non riuscire. Ciò non influisce sul riconoscimento o sul riconoscimento in corso. La connessione potrebbe cadere per vari motivi, il riconoscimento tenterà sempre di reinstituire la connessione in base alle esigenze per garantire operazioni in corso. In tutti questi casi connected/disconnected gli eventi indicherà la modifica dello stato della connessione.

Nota

Aggiornato nella versione 1.17.0.

Costruttore per l'uso interno.

Ereditarietà

builtins.object

Connection

Costruttore

Connection(handle: c_void_p)

Parametri

Nome	Descrizione
handle Necessario

Metodi

close	Chiude la connessione al servizio. Gli utenti possono chiamare close facoltativamente per arrestare manualmente la connessione dell'oggetto associato Recognizer. La chiamata potrebbe non riuscire, a seconda dello stato del Recognizerprocesso di . Tuttavia, l'errore non influisce sullo stato dell'oggetto associato Recognizer.
from_dialog_service_connector	Ottiene l'istanza Connection dal connettore del servizio di dialogo specificato.
from_recognizer	Ottiene l'istanza Connection dal riconoscimento specificato.
from_speech_synthesizer	Ottiene l'istanza Connection dal sintetizzatore vocale specificato. Nota Aggiunta nella versione 1.17.0.
open	Avvia la configurazione della connessione al servizio. Gli utenti possono chiamare open facoltativamente per configurare manualmente una connessione in anticipo prima di avviare il riconoscimento sull'oggetto Recognizer associato a .Connection Dopo aver avviato il riconoscimento, la chiamata openpotrebbe non riuscire, a seconda dello stato del Recognizerprocesso di . Tuttavia, l'errore non influisce sullo stato dell'oggetto associato Recognizer. Nota In caso contrario, la connessione potrebbe non essere ancora pronta. Sottoscrivere l'oggetto evento connesso da ricevere una notifica quando viene stabilita la connessione.
set_message_property	Aggiunge un parametro in un messaggio al servizio. Nota Questo metodo non funziona per la connessione di SpeechSynthesizer.

close

Chiude la connessione al servizio. Gli utenti possono chiamare close facoltativamente per arrestare manualmente la connessione dell'oggetto associato Recognizer. La chiamata potrebbe non riuscire, a seconda dello stato del Recognizerprocesso di . Tuttavia, l'errore non influisce sullo stato dell'oggetto associato Recognizer.

close()

from_dialog_service_connector

Ottiene l'istanza Connection dal connettore del servizio di dialogo specificato.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parametri

Nome	Descrizione
dialog_service_connector Necessario

from_recognizer

Ottiene l'istanza Connection dal riconoscimento specificato.

from_recognizer(recognizer: Recognizer) -> Connection

Parametri

Nome	Descrizione
recognizer Necessario

from_speech_synthesizer

Ottiene l'istanza Connection dal sintetizzatore vocale specificato.

Nota

Aggiunta nella versione 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parametri

Nome	Descrizione
speech_synthesizer Necessario

open

Avvia la configurazione della connessione al servizio. Gli utenti possono chiamare open facoltativamente per configurare manualmente una connessione in anticipo prima di avviare il riconoscimento sull'oggetto Recognizer associato a .Connection Dopo aver avviato il riconoscimento, la chiamata openpotrebbe non riuscire, a seconda dello stato del Recognizerprocesso di . Tuttavia, l'errore non influisce sullo stato dell'oggetto associato Recognizer.

Nota

In caso contrario, la connessione potrebbe non essere ancora pronta. Sottoscrivere l'oggetto

evento connesso da ricevere una notifica quando viene stabilita la connessione.

open(for_continuous_recognition: bool)

Parametri

Nome	Descrizione
forContinuousRecognition Necessario	indica se la connessione viene usata per il riconoscimento continuo o il riconoscimento a colpo singolo. Non ha alcun effetto se la connessione è da SpeechSynthsizer.
for_continuous_recognition Necessario

set_message_property

Aggiunge un parametro in un messaggio al servizio.

Nota

Questo metodo non funziona per la connessione di SpeechSynthesizer.

set_message_property(path: str, property_name: str, property_value: str)

Parametri

Nome	Descrizione
path Necessario	Percorso del messaggio.
property_name Necessario	Nome della proprietà da impostare.
property_value Necessario	Valore della proprietà da impostare.

Attributi

connected

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

disconnected

Evento Disconnesso per indicare che il riconoscimento viene disconnesso dal servizio.