Animando um personagem

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

Depois que um caractere é carregado, você pode usar vários métodos do Microsoft Agent para animar o personagem. O primeiro que você usa normalmente é o método Show. Mostrar torna o quadro do personagem visível e reproduz a animação atribuída ao estado Mostrando do personagem.

Quando o quadro do personagem estiver visível, você poderá usar o método Play, especificando o nome de uma animação, para reproduzir essa animação. Os nomes de animação são específicos para uma definição de caractere. À medida que uma animação é reproduzida, a forma da janela muda para corresponder à imagem no quadro. Isso resulta em uma imagem gráfica móvel, ou sprite, exibida na parte superior da área de trabalho e de todas as janelas, ou z-order.

Se o arquivo do personagem estiver armazenado localmente, você pode simplesmente chamar o método Play. Em outros casos, como quando você carregou um arquivo . Caractere ACF de um servidor HTTP, você deve usar o método Get (ou Prepare) para recuperar primeiro os dados de animação. Isso fará com que o Agente solicite o arquivo de animação do servidor e o armazene no buffer do navegador na máquina local.

O método Speak permite programar o personagem para falar, sincronizando automaticamente a saída com o movimento dos lábios. Mais detalhes são abordados na seção Saída deste documento.

Você pode usar o método MoveTo para posicionar o personagem em um novo local. Quando se chama o método MoveTo, o Microsoft Agent reproduz automaticamente a animação apropriada com base na localização atual do personagem e depois move o quadro da personagem. Da mesma forma, quando você chama GestureAt, o Microsoft Agent reproduz a animação gesticulante apropriada com base no local do personagem e no local especificado na chamada.

Para ocultar o caractere, chame o método Ocultar. Isso reproduz automaticamente o personagem associado ao estado Ocultando do personagem e, em seguida, oculta o quadro do personagem. No entanto, você também pode ocultar ou mostrar um caractere definindo a propriedade Visible do personagem.

O Microsoft Agent processa todas as chamadas de animação, ou solicitações de , de forma assíncrona. Isso permite que o código do seu aplicativo continue manipulando outros eventos enquanto a solicitação está sendo processada. Por exemplo, chamadas para o método Play colocam a animação na fila do personagem, permitindo que as animações sejam reproduzidas sequencialmente. No entanto, isso significa que você não pode assumir que uma chamada para outras funções será necessariamente executada após uma animação que segue em seu código. Por exemplo, normalmente, uma instrução após uma chamada para Play ou MoveTo será executada antes que a animação termine.

Você pode sincronizar o seu código com animações na fila de um personagem criando uma referência de objeto para o pedido de animação e, quando a animação for iniciada ou concluída, monitorizando os eventos de pedido que o servidor utiliza para notificar os clientes sobre o personagem. Por exemplo, se quiser que uma caixa de mensagem apareça quando o caractere terminar uma animação, você pode colocar a chamada da caixa de mensagem em sua sub-rotina de manipulação de eventosRequestComplete, verificando a ID de solicitação específica.

Quando um personagem está oculto, o servidor não reproduz animações; no entanto, ele ainda enfileira e processa a solicitação de animação (reproduz a animação) e passa um status de solicitação de volta para o cliente. No estado oculto, o caractere não pode tornar-se ativo para entrada. No entanto, se o usuário fala o nome do caractere (quando a entrada de fala está habilitada), o servidor mostra automaticamente o caractere.

Quando o aplicativo cliente carrega vários caracteres ao mesmo tempo, os serviços de animação do Microsoft Agent permitem que você anime caracteres independentemente ou use os métodos Wait, Interruptou Stop para sincronizar suas animações entre si.

O Microsoft Agent também reproduz outras animações automaticamente para você. Por exemplo, se o estado do personagem não tiver mudado por vários segundos, o Agente começará a reproduzir animações atribuídas às animações Idling do personagem. Da mesma forma, quando a entrada de fala está habilitada, o Agente reproduz as animações Listening do personagem e, em seguida, animações Hearing quando um enunciado é detetado. Essas animações gerenciadas por servidor são chamadas de estados e são definidas quando um caractere é criado. Para obter mais informações, consulte Criando caracteres para o Microsoft Agent.