Propriedade SRModeID

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

Descrição

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

Sintaxe

agent**. 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.

 

Comentários

A propriedade determina o mecanismo de reconhecimento de fala usado pelo caractere para entrada de fala. A ID do modo de 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 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 Agent 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), a consulta ou 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 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 que dão suporte aos requisitos de SAPI do Microsoft Agent podem ser instalados e usados com o Agent.

Observação

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

 

Observação

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