Compartilhar via


Propriedade SRModeID

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

de descrição do

Retorna ou define o mecanismo de reconhecimento de fala que o caractere usa.

de sintaxe

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

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

 

Observações

A propriedade determina o mecanismo de reconhecimento de fala usado pelo caractere para entrada de fala. A 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 seude 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 LanguageID do 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 do modo do mecanismo que o SAPI retorna com base na configuração LanguageID do caractere. Se você ainda não definiu o languageID do caractere, o Agente retornará a ID do 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 exige que SpeechInput.Enabled seja 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 caractere), 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 chave de escuta está disponível e a Dica de Escuta é exibivel. (A tecla De escuta e a dica de escuta são habilitadas somente se elas também estiverem habilitadas nas Opções avançadas de caracteres.) No entanto, se você consultar a propriedade quando a fala estiver desabilitada, o servidor não iniciará serviços de fala.

Essa propriedade se aplica somente ao uso do caractere pelo aplicativo cliente; a configuração não afeta outros clientes do caractere ou outros caracteres do aplicativo cliente.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de Fala da Microsoft. Mecanismos compatíveis com os requisitos sapi do Microsoft Agent podem ser instalados e usados com o Agent.

Nota

Essa propriedade também retornará a cadeia de caracteres vazia se você não tiver suporte de som compatível instalado em seu sistema.

 

Nota

A consulta a essa propriedade normalmente não retorna um erro. No entanto, se o mecanismo de fala levar um tempo anormalmente longo para ser carregado, você poderá receber um erro indicando que a consulta atingiu o tempo limite.

 

Consulte Também

propriedade LanguageID