Partilhar via


Propriedade SRModeID

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

Descrição

Retorna ou define o mecanismo de reconhecimento de fala usado pelo caractere.

Sintaxe

agente**. Caracteres("CharacterID"). SRModeID** [ = ModeID]

Peça Descrição
ModeID Uma expressão de cadeia de caracteres que corresponde à ID de modo de um mecanismo de fala.

 

Comentários

A propriedade determina o mecanismo de reconhecimento de fala usado pelo caractere para entrada de fala. O ID de modo para um mecanismo de reconhecimento de fala é uma cadeia de caracteres formatada definida pelo fornecedor de fala que identifica exclusivamente o mecanismo. Para obter mais informações, consulte acessando um mecanismo de fala em seu código.

Se você especificar uma ID de modo para um mecanismo de fala que não está instalado, se o usuário tiver desabilitado o reconhecimento de fala (na folha de propriedades do Microsoft Agent) ou se o idioma do mecanismo de fala especificado não corresponder à configuração deLanguageIDdo caractere, o servidor gerará um erro.

Se você consultar essa propriedade e ainda não tiver definido (com êxito) o mecanismo de reconhecimento de fala, o servidor retornará a ID de modo do mecanismo que o SAPI retorna com base na configuração LanguageID do personagem. Se você não tiver definido o LanguageID do personagem, o Agent retornará o ID de modo do mecanismo que o SAPI retorna com base na configuração de ID de idioma padrão do usuário. Se não houver nenhum mecanismo correspondente, o servidor retornará uma cadeia de caracteres vazia (""). Consultar essa propriedade não requer que SpeechInput.Enabled ser definido como True. No entanto, se você consultar a propriedade quando a entrada de fala estiver desabilitada, o servidor retornará uma cadeia de caracteres vazia.

Quando a entrada de fala estiver habilitada (na janela Opções Avançadas de Caracteres), consultar ou definir essa 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 Listening pode ser exibida. (A tecla de Escuta e a Dica de Escuta serão ativadas somente se 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.

Esta propriedade aplica-se apenas ao uso do caractere pelo seu aplicativo cliente; A configuração não afeta outros clientes do caractere ou outros caracteres do seu aplicativo cliente.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de fala da Microsoft. Os mecanismos que suportam os requisitos SAPI do Microsoft Agent podem ser instalados e usados com o Agent.

Observação

Esta propriedade também retorna a cadeia de caracteres vazia se você não tiver suporte de som compatível instalado no seu sistema.

 

Observação

Consultar essa propriedade normalmente não retorna um erro. No entanto, se o mecanismo de fala demorar um tempo anormalmente longo para carregar, você pode receber um erro indicando que a consulta expirou.

 

Ver também

propriedade LanguageID