Listen, metodo

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

Descrizione

Attiva la modalità di ascolto (riconoscimento vocale) per un periodo di tempo.

Sintassi

Agente. Personaggi ("CharacterID"). Stato listen**

Parte	Descrizione
State	Obbligatorio. Valore booleano che determina se attivare o disattivare la modalità di ascolto. Vero Attiva la modalità di ascolto. False Disattiva la modalità di ascolto.

Commenti

L'impostazione di questo metodo su True abilita la modalità di ascolto (attiva il riconoscimento vocale) per un periodo di tempo fisso (10 secondi). Anche se non è possibile impostare il valore del timeout, è possibile disattivare la modalità di ascolto prima della scadenza del timeout. Se si imposta correttamente la modalità di ascolto (o un altro client) e si tenta di impostare questa proprietà su True prima della scadenza del timeout, il metodo ha esito positivo e reimposta il timeout. Tuttavia, se la modalità di ascolto è attivata perché l'utente preme il tasto Listening, il metodo ha esito positivo, ma il timeout viene ignorato e la modalità di ascolto termina in base all'interazione dell'utente con il tasto Ascolto.

Questo metodo ha esito positivo solo quando viene chiamato dal client attivo di input e se sono stati avviati i servizi voce. Per assicurarsi che i servizi voce siano stati avviati, eseguire query o impostare SRModeID o impostare l'impostazione Voce per un comando prima di chiamare Listen altrimenti il metodo avrà esito negativo. Per rilevare l'esito positivo di questo metodo, chiamarlo come funzione e restituirà un valore booleano che indica se il metodo ha avuto esito positivo.

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

Il metodo ha esito negativo anche se l'utente preme il tasto Listen e si tenta di impostare Listen su False. Tuttavia, se l'utente ha rilasciato la chiave di ascolto e la modalità di ascolto non è scaduta, l'operazione avrà esito positivo.

L'ascolto ha esito negativo anche se non è disponibile alcun motore di riconoscimento vocale compatibile che corrisponde all'impostazione LanguageID del carattere, l'utente ha disabilitato l'input vocale usando la finestra delle proprietà di Microsoft Agent o il dispositivo audio è occupato.

Quando questo metodo viene impostato correttamente su True, il server attiva l'evento ListenStart . Il server invia ListenComplete al termine del timeout della modalità di ascolto o quando si imposta Listen su False.

Questo metodo non chiama automaticamente Stop e riproduce un'animazione dello stato di ascolto perché il server esegue quando viene premuto il tasto Listening. In questo modo puoi determinare se interrompere l'animazione corrente usando l'animazione ListenStart chiamando Stop e riproducendo la tua animazione appropriata. Tuttavia, il server chiama Stop e riproduce un'animazione dello stato di udito quando viene rilevata un'espressione utente.

Vedere anche

Proprietà LanguageID, evento ListenComplete, evento ListenStart