Condividi tramite

IAgentCharacterEx::SetSRModeID

  • Articolo

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

HRESULT SetSRModeID(
   BSTR bszModeID  // speech recognition engine ID
);

Imposta l'ID modalità del motore di riconoscimento vocale impostato per il carattere.

  • Restituisce S_OK per indicare che l'operazione è riuscita.

bszModeID

Impostazione id modalità del motore di riconoscimento vocale per il carattere.

Questa impostazione imposta il motore per l'input vocale di un carattere. L'ID modalità per un motore di riconoscimento vocale è il GUID definito dal fornitore del riconoscimento vocale che identifica in modo univoco la modalità del motore (formattata con parentesi graffe e trattini). Per altre informazioni, vedere la documentazione di Microsoft Speech SDK.

Se si specifica un ID modalità che non corrisponde all'impostazione della lingua del carattere, se l'utente ha disabilitato il riconoscimento vocale (nella finestra delle proprietà di Microsoft Agent) o il motore non è installato, questa chiamata avrà esito negativo. Se non si imposta un ID modalità motore di riconoscimento vocale per il carattere, il server ne imposta uno corrispondente all'impostazione della lingua del carattere (usando le interfacce dell'API Riconoscimento vocale Microsoft).

Quando l'input vocale è abilitato nella finestra delle proprietà agent (Opzioni carattere avanzate), l'impostazione di questa proprietà caricherà il motore associato (se non è già caricato) e avvierà i servizi voce. Vale a dire, la chiave di ascolto è disponibile e il suggerimento di ascolto è visualizzabile. Il tasto di ascolto e il suggerimento per l'ascolto sono abilitati solo se sono abilitati anche in Opzioni carattere avanzate. Tuttavia, se si esegue una query sulla proprietà quando il riconoscimento vocale è disabilitato, il server non avvia i servizi voce.

Questa proprietà si applica solo al client del carattere; l'impostazione non riflette l'impostazione per altri client del carattere o di altri caratteri del client.

I requisiti del motore di riconoscimento vocale di Microsoft Agent si basano sull'API Riconoscimento vocale Microsoft. I motori che supportano i requisiti SAPI di Microsoft Agent possono essere installati e usati con Agent.

Vedere anche

IAgentCharacterEx::GetSRModeID