Evento command

[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

Subagent_Command(ByValUserInput**)**

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. Confidenza Valore intero lungo che indica l'assegnazione del punteggio 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). Alt1Confidence Valore long integer che indica il punteggio di attendibilità per il comando migliore successivo (secondo). Alt1Voice Valore stringa che identifica il testo vocale per la corrispondenza migliore alternativa successiva. Alt2Name Valore stringa che identifica il nome della terza corrispondenza di comando migliore. Alt2Confidence Numero intero lungo che identifica l'assegnazione dei punteggi di attendibilità per la terza corrispondenza di comando migliore. Alt2Voice Valore stringa che identifica il testo vocale per la terza corrispondenza di comando migliore. Conteggio Valore intero lungo che indica il numero di alternative restituite.

Commenti

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 comandi corrispondenti possibili in Count , nonché il nome, il punteggio 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 ottenere lo stesso nome di comando restituito 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 la restituzione di alternative e punteggi di attendibilità.