Partilhar via


IAgentCommandsEx::SetGlobalVoiceCommandsEnabled

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

HRESULT SetGlobalVoiceCommandsEnabled(
 long bEnable  // Enabled setting for Agent's global voice commands
);

Define a propriedadeEnabled para a gramática de voz dos comandos globais do Microsoft Agent.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

bAtivar

Um valor booleano que define se a gramática de voz dos comandos globais do Agent está habilitada. True habilita a gramática da voz; Falso o desativa.

O Microsoft Agent adiciona automaticamente parâmetros de voz (gramática) para abrir e fechar a janela de comandos de voz e para mostrar e ocultar o caractere. Quando definido como False, o Agent desativa todos os parâmetros de voz para esses comandos, bem como os parâmetros de voz para oCaption dos objetos Command de outros clientes. Isso permite eliminá-los da gramática ativa atual do seu cliente. No entanto, como isso potencialmente bloqueia o acesso de voz a outros clientes, redefina essa propriedade para True depois de processar a entrada de voz do usuário.

A desativação da propriedade não afeta o menu pop-up do personagem. Os comandos globais adicionados pelo servidor ainda aparecerão. Não é possível removê-los do menu pop-up.

Ver também

IAgentCommandsEx::GetGlobalVoiceCommandsEnabled