Condividi tramite

Command, evento

  • Articolo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Descrizione

Si verifica quando l'utente sceglie un comando (client).

Sintassi

Sub agent_Command (ByVal UserInput**)**

In parte Descrizione
UserInput Identifica l'oggetto Command restituito dal server.
È possibile accedere alle proprietà seguenti dall'oggetto Command :
CharacterID
Valore stringa che identifica il nome (ID) del carattere che ha ricevuto il comando.
Nome
Valore stringa che identifica il nome (ID) del comando.
Attendibilità
Valore Intero lungo che indica l'assegnazione dei punteggi di attendibilità per il comando.
Chiamata vocale
Valore stringa che identifica il testo vocale per il comando.
Alt1Name
Valore stringa che identifica il nome del comando migliore successivo (secondo).
Alt1Confidenza
Valore intero lungo che indica il punteggio di attendibilità per il comando migliore successivo (secondo).
Alt1Voice
Valore stringa che identifica il testo vocale per la corrispondenza migliore del comando alternativo successivo.
Alt2Name
Valore stringa che identifica il nome della terza corrispondenza di comando migliore.
Alt2Confidence
Intero lungo che identifica il punteggio di attendibilità per la terza corrispondenza migliore del comando.
Alt2Voice
Valore stringa che identifica il testo vocale per la terza corrispondenza migliore del comando.
Conteggio
Valore intero lungo che indica il numero di alternative restituite.

Osservazioni:

Il server invia una notifica a questo evento quando l'applicazione è attiva dall'input e l'utente sceglie un comando dal menu a comparsa di input parlato o carattere. L'evento restituisce il numero di possibili comandi corrispondenti in Count , nonché il nome, l'assegnazione dei punteggi di attendibilità e il testo vocale per tali corrispondenze.

Se l'input vocale attiva questo evento, il server restituisce una stringa che identifica la corrispondenza migliore nel parametro Name e la seconda e la terza corrispondenza migliore in Alt1Name e Alt2Name . Una stringa vuota indica che l'input non corrisponde ad alcun comando definito dall'applicazione; Ad esempio, potrebbe trattarsi di uno dei comandi definiti del server. Se il comando è stato confrontato con il comando dell'agente; Ad esempio, Hide, viene restituita una stringa vuota nel parametro Name, ma si riceverà comunque il testo sentito nel parametro Voice.

È possibile che venga restituito lo stesso nome di comando in più di una voce. I parametri Confidence, Alt1Confidence e Alt2Confidence restituiscono i punteggi relativi, nell'intervallo compreso tra -100 e 100, restituiti dal motore di riconoscimento vocale per ogni rispettiva corrispondenza. I parametri Voice, Alt1Voice e Alt2Voice restituiscono il testo vocale corrispondente al motore di riconoscimento vocale per ogni alternativa. Se Count restituisce zero (0), il server ha rilevato l'input parlato, ma ha determinato che non è presente alcun comando corrispondente.

Se l'input vocale non è l'origine per il comando, ad esempio, se l'utente ha selezionato il comando dal menu a comparsa del carattere, il server restituisce il nome (ID) del comando selezionato nella proprietà Name. Restituisce anche il valore del parametro Confidence come 100 e il valore dei parametri Voice come stringa vuota (""). Alt1Name e Alt2Name restituiscono anche stringhe vuote. Alt1Confidence e Alt2Confidence restituiscono zero (0) e Alt1Voice e Alt2Voice restituiscono stringhe vuote. Count restituisce 1.

Nota

Non tutti i motori di riconoscimento vocale possono restituire tutti i valori per tutti i parametri di questo evento. Rivolgersi al fornitore del motore per determinare se il motore supporta l'interfaccia dell'API Riconoscimento vocale Microsoft per restituire alternative e punteggi di attendibilità.