Método Listen

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

Descrição

Ativa o modo escuta (reconhecimento de fala) por um período cronometrado.

Sintaxe

Agente. Caracteres ("CharacterID"). Estado Listen**

Parte	Descrição
State	Obrigatórios. Um valor booliano que determina se o modo de escuta deve ser ativado ou desativado. Verdade Ativa o modo de escuta. False Desativa o modo de escuta.

Comentários

Definir esse método como True habilita o modo de escuta (ativa o reconhecimento de fala) por um período fixo de tempo (10 segundos). Embora não seja possível definir o valor do tempo limite, você pode desativar o modo escuta antes que o tempo limite expire. Se você (ou outro cliente) definir com êxito o modo escuta e tentar definir essa propriedade como True antes que o tempo limite expire, o método terá êxito e redefinirá o tempo limite. No entanto, se o modo escuta estiver ativado porque o usuário está pressionando a tecla Listening, o método terá êxito, mas o tempo limite será ignorado e o modo de Escuta terminará com base na interação do usuário com a tecla Listening.

Esse método só terá êxito quando chamado pelo cliente ativo de entrada e se os serviços de fala tiverem sido iniciados. Para garantir que os serviços de fala tenham sido iniciados, consulte ou defina o SRModeID ou defina a configuração de Voz para um Comando antes de chamar Escutar , caso contrário, o método falhará. Para detectar o sucesso desse método, chame-o como uma função e retornará um valor booliano indicando se o método foi bem-sucedido.

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

O método também falhará se o usuário estiver pressionando a tecla Listen e você tentar definir Listen como False. No entanto, se o usuário tiver liberado a tecla Listening e o modo Escuta não tiver cronometrado, ele terá êxito.

A escuta também falhará se não houver nenhum mecanismo de fala compatível disponível que corresponda à configuração LanguageID do caractere, o usuário tiver desabilitado a entrada de fala usando a folha de propriedades do Microsoft Agent ou o dispositivo de áudio estiver ocupado.

Quando você define esse método com êxito como True, o servidor dispara o evento ListenStart . O servidor envia ListenComplete quando o tempo limite do modo de escuta é concluído ou quando você define Escutarcomo False.

Esse método não chama parar e reproduzir automaticamente uma animação de estado de escuta como o servidor faz quando a tecla Listening é pressionada. Isso permite determinar se a animação atual deve ser interrompida usando a animação ListenStart chamando Stop e reproduzindo sua própria animação apropriada. No entanto, o servidor chama Stop e reproduz uma animação de estado de audição quando um enunciado do usuário é detectado.

Consulte Também

Propriedade LanguageID, evento ListenComplete, evento ListenStart