Método Listen

[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

Ativa o modo de Compreensão Auditiva (reconhecimento de voz) por um período cronometrado.

Sintaxe

agente.Caracteres("CharacterID"). Ouvir** Estado

Peça	Descrição
Estado	Necessário. Um valor booleano que determina se o modo de escuta deve ser ativado ou desativado. True ativa o modo de audição. Falso desativa o modo de escuta.

Comentários

Definir esse método como True habilita o modo de Compreensão Auditiva (ativa o reconhecimento de fala) por um período de tempo fixo (10 segundos). Embora não seja possível definir o valor do tempo limite, você pode desativar o modo de escuta antes que o tempo limite expire. Se você (ou outro cliente) definir com êxito o modo de 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 de escuta estiver ativado porque o usuário está pressionando a tecla de escuta, o método será bem-sucedido, mas o tempo limite é ignorado e o modo de escuta termina com base na interação do usuário com a tecla de escuta.

Esse método só é bem-sucedido quando chamado pelo cliente de entrada ativa e se os serviços de fala tiverem sido iniciados. Para garantir que os serviços de fala foram iniciados, consulte ou defina o SRModeID ou defina a configuração Voice para umde comandoantes de chamar Listen caso contrário, o método falhará. Para detetar o sucesso desse método, chame-o como uma função e ele retornará um valor booleano 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 Listening e você tentar definir Listen para False. No entanto, se o usuário tiver liberado a tecla de escuta e o modo de escuta não tiver expirado, ele terá êxito.

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

Quando você define com êxito esse método como True, o servidor dispara o eventoListenStart. O servidor envia ListenComplete quando o tempo limite do modo de Escuta é concluído ou quando você define Listen para False.

Este método não chama automaticamente Stop e reproduz uma animação de estado de escuta como o servidor faz quando a tecla de escuta é pressionada. Isso permite que você determine se deseja interromper a animação atual 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 uma declaração do usuário é detetada.

Ver também

propriedade LanguageID, evento ListenCompleteevento ListenStart