IntentRecognizer Classe

Oltre a eseguire il riconoscimento vocale, IntentRecognizer estrae informazioni strutturate sulla finalità dell'altoparlante.

Ereditarietà
IntentRecognizer

Costruttore

IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)

Parametri

Nome Descrizione
speech_config
Necessario

Configurazione per il riconoscimento vocale.

audio_config

Configurazione per l'input audio.

valore predefinito: None
intents

Finalità da un'iterabile su coppie di (modello, intent_id) o (simple_phrase, intent_id) da riconoscere.

valore predefinito: None

Metodi

add_all_intents

Aggiunge tutte le finalità dal modello di Language Understanding specificato.

add_intent

Aggiungere una finalità al riconoscitore. Esistono diversi modi per eseguire questa operazione:

  • add_intent(simple_phrase): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica.

  • add_intent(simple_phrase, intent_id): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica. Una volta riconosciuto, l'ID finalità del risultato corrisponderà all'ID fornito qui.

  • add_intent(model, intent_name): aggiunge una singola finalità in base al nome dall'oggetto specificato LanguageUnderstandingModel.

  • add_intent(model, intent_name, intent_id): aggiunge una singola finalità per nome dall'oggetto specificato LanguageUnderstandingModel.

  • add_intent(trigger, intent_id): aggiunge l'oggetto IntentTrigger specificato. IntentTrigger.

add_intents

Aggiungere finalità da coppie iterabili di (modello, intent_id) o (simple_phrase, intent_id).

recognize_once

Esegue il riconoscimento in modalità di blocco (sincrona). Restituisce il risultato dopo il riconoscimento di una singola espressione. La fine di una singola espressione viene determinata restando in ascolto del silenzio al termine o finché non vengono elaborati al massimo 15 secondi di audio. L'attività restituisce il testo di riconoscimento come risultato. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.

recognize_once_async

Esegue il riconoscimento in modalità non di blocco (asincrona). Verrà riconosciuta una singola espressione. La fine di una singola espressione viene determinata restando in ascolto del silenzio al termine o finché non vengono elaborati al massimo 15 secondi di audio. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.

start_continuous_recognition

Avvia in modo sincrono l'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.

start_continuous_recognition_async

Avvia in modo asincrono un'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.

start_keyword_recognition

Configura in modo sincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition() per terminare il riconoscimento avviato dalla parola chiave.

start_keyword_recognition_async

Configura in modo asincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition_async() per terminare il riconoscimento avviato dalla parola chiave.

stop_continuous_recognition

Termina in modo sincrono l'operazione di riconoscimento continuo.

stop_continuous_recognition_async

Termina in modo asincrono l'operazione di riconoscimento continuo.

stop_keyword_recognition

Termina in modo sincrono il riconoscimento avviato dalla parola chiave.

stop_keyword_recognition_async

Termina in modo asincrono il riconoscimento avviato dalla parola chiave.

add_all_intents

Aggiunge tutte le finalità dal modello di Language Understanding specificato.

add_all_intents(model: LanguageUnderstandingModel)

Parametri

Nome Descrizione
model
Necessario

add_intent

Aggiungere una finalità al riconoscitore. Esistono diversi modi per eseguire questa operazione:

  • add_intent(simple_phrase): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica.

  • add_intent(simple_phrase, intent_id): aggiunge una frase semplice che può essere pronunciata dall'utente, che indica una finalità utente specifica. Una volta riconosciuto, l'ID finalità del risultato corrisponderà all'ID fornito qui.

  • add_intent(model, intent_name): aggiunge una singola finalità in base al nome dall'oggetto specificato LanguageUnderstandingModel.

  • add_intent(model, intent_name, intent_id): aggiunge una singola finalità per nome dall'oggetto specificato LanguageUnderstandingModel.

  • add_intent(trigger, intent_id): aggiunge l'oggetto IntentTrigger specificato. IntentTrigger.

add_intent(*args)

Parametri

Nome Descrizione
model
Necessario

Modello di comprensione del linguaggio contenente la finalità.

intent_name
Necessario

Nome della singola finalità da includere nel modello di comprensione del linguaggio.

simple_phrase
Necessario

Frase corrispondente alla finalità.

intent_id
Necessario

Stringa ID personalizzata da restituire nella proprietà intent_id dell'oggetto IntentRecognitionResult.

trigger
Necessario

IntentTrigger corrispondente alla finalità.

add_intents

Aggiungere finalità da coppie iterabili di (modello, intent_id) o (simple_phrase, intent_id).

add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])

Parametri

Nome Descrizione
intents
Necessario

Finalità da un'iterabile su coppie di (modello, intent_id) o (simple_phrase, intent_id) da riconoscere.

intents_iter
Necessario

recognize_once

Esegue il riconoscimento in modalità di blocco (sincrona). Restituisce il risultato dopo il riconoscimento di una singola espressione. La fine di una singola espressione viene determinata restando in ascolto del silenzio al termine o finché non vengono elaborati al massimo 15 secondi di audio. L'attività restituisce il testo di riconoscimento come risultato. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.

recognize_once() -> IntentRecognitionResult

Restituisce

Tipo Descrizione

Valore del risultato del riconoscimento sincrono.

recognize_once_async

Esegue il riconoscimento in modalità non di blocco (asincrona). Verrà riconosciuta una singola espressione. La fine di una singola espressione viene determinata restando in ascolto del silenzio al termine o finché non vengono elaborati al massimo 15 secondi di audio. Per il riconoscimento prolungato e a più espressioni, usare start_continuous_recognition_async.

recognize_once_async() -> ResultFuture

Restituisce

Tipo Descrizione

Valore futuro contenente il valore del risultato del riconoscimento asincrono.

start_continuous_recognition

Avvia in modo sincrono l'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.

start_continuous_recognition()

start_continuous_recognition_async

Avvia in modo asincrono un'operazione di riconoscimento continuo. Per ricevere i risultati del riconoscimento, l'utente deve connettersi a EventSignal. Chiamare stop_continuous_recognition_async per arrestare il riconoscimento.

start_continuous_recognition_async() -> ResultFuture

Restituisce

Tipo Descrizione

Un futuro che viene soddisfatto dopo l'inizializzazione del riconoscimento.

start_keyword_recognition

Configura in modo sincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition() per terminare il riconoscimento avviato dalla parola chiave.

start_keyword_recognition(model: KeywordRecognitionModel)

Parametri

Nome Descrizione
model
Necessario

modello di riconoscimento delle parole chiave che specifica la parola chiave da riconoscere.

start_keyword_recognition_async

Configura in modo asincrono il riconoscitore con il modello di parole chiave specificato. Dopo aver chiamato questo metodo, il riconoscitore è in ascolto della parola chiave per avviare il riconoscimento. Chiamare stop_keyword_recognition_async() per terminare il riconoscimento avviato dalla parola chiave.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parametri

Nome Descrizione
model
Necessario

modello di riconoscimento delle parole chiave che specifica la parola chiave da riconoscere.

Restituisce

Tipo Descrizione

Un futuro che viene soddisfatto dopo l'inizializzazione del riconoscimento.

stop_continuous_recognition

Termina in modo sincrono l'operazione di riconoscimento continuo.

stop_continuous_recognition()

stop_continuous_recognition_async

Termina in modo asincrono l'operazione di riconoscimento continuo.

stop_continuous_recognition_async()

Restituisce

Tipo Descrizione

Un futuro che viene soddisfatto dopo che il riconoscimento è stato arrestato.

stop_keyword_recognition

Termina in modo sincrono il riconoscimento avviato dalla parola chiave.

stop_keyword_recognition()

stop_keyword_recognition_async

Termina in modo asincrono il riconoscimento avviato dalla parola chiave.

stop_keyword_recognition_async()

Restituisce

Tipo Descrizione

Un futuro che viene soddisfatto dopo che il riconoscimento è stato arrestato.

Attributi

authorization_token

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

il token di autorizzazione scade, il chiamante deve aggiornarlo chiamando questo setter con un

nuovo token valido. In caso contrario, il riconoscitore rileva errori durante il riconoscimento.

canceled

Segnalare gli eventi contenenti risultati di riconoscimento annullati (indicante 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 IntentRecognitionCanceledEventArgsdi , come singolo argomento.

endpoint_id

ID endpoint di un modello di riconoscimento vocale personalizzato usato per il riconoscimento o un modello di voce personalizzato per la sintesi vocale.

properties

Raccolta di proprietà e relativi valori definiti per questo strumento di riconoscimento.

recognized

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

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

recognizing

Segnalare gli eventi contenenti risultati intermedi del riconoscimento.

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

session_started

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.

session_stopped

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.

speech_end_detected

Segnale per gli eventi che indicano la fine del parlato.

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

speech_start_detected

Segnale per gli eventi che indicano l'inizio del parlato.

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