Compartilhar via

IAgentCharacterEx::SetSRModeID

  • Artigo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

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

Define a ID do modo do mecanismo de reconhecimento de fala definido para o caractere.

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

bszModeID

A configuração de ID do modo do mecanismo de reconhecimento de fala para o caractere.

Essa configuração define o mecanismo para a entrada de fala de um caractere. A ID do modo para um mecanismo de reconhecimento de fala é o GUID definido pelo fornecedor de fala que identifica exclusivamente o modo do mecanismo (formatado com chaves e traços). Para obter mais informações, consulte a documentação do SDK de Fala da Microsoft.

Se você especificar uma ID de modo que não corresponda à configuração de idioma do caractere, se o usuário tiver desabilitado o reconhecimento de fala (na folha de propriedades do Microsoft Agent) ou se o mecanismo não estiver instalado, essa chamada falhará. Se você não definir uma ID do modo do mecanismo de reconhecimento de fala para o caractere, o servidor definirá uma que corresponda à configuração de linguagem do caractere (usando interfaces da API de Fala da Microsoft).

Quando a entrada de fala estiver habilitada na folha de propriedades agent (Opções avançadas de caractere), a configuração dessa propriedade carregará o mecanismo associado (se ainda não estiver carregado) e iniciará os serviços de fala. Ou seja, a tecla Listening está disponível e a Dica de Escuta pode ser exibida. (A tecla Listening e a dica de escuta serão habilitadas somente se elas também estiverem habilitadas em Opções avançadas de caracteres.) No entanto, se você consultar a propriedade quando a fala estiver desabilitada, o servidor não iniciará os serviços de fala.

Essa propriedade se aplica somente ao cliente do caractere; a configuração não reflete a configuração para outros clientes do caractere ou outros caracteres do cliente.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de Fala da Microsoft. Os mecanismos que dão suporte aos requisitos sapi do Microsoft Agent podem ser instalados e usados com o Agent.

Consulte Também

IAgentCharacterEx::GetSRModeID