IAgentCharacter::P repare

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

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

Recupera dados de animação para um personagem.

• Retorna S_OK para indicar que a operação foi bem-sucedida. Quando a função retorna, pdwReqID contém a ID da solicitação.

dwType

Um valor que indica o tipo de dados de animação a ser carregado que deve ser um dos seguintes:

Valor	Descrição
const shortPREPARE_ANIMATION não assinado = 0;	Dados de animação de um personagem.
const shortPREPARE_STATE não assinado = 1;	Dados de estado de um personagem.
const shortPREPARE_WAVE não assinado = 2	O arquivo de som de um caractere (. WAV ou . LWV) para produção falada.

bszName

O nome da animação ou estado.

O nome da animação é baseado no definido para o caractere quando ele foi salvo usando o Editor de Caracteres do Microsoft Agent.

Para estados, o valor pode ser um dos seguintes:

	Descrição
"Gesticulação"	Para recuperar todas as animações de estado Gesturing.
"GesturingDown"	Para recuperar GesturingDown animações.
"GesturingLeft"	Para recuperar GesturingLeft animações.
"GesturingRight"	Para recuperar GesturingRight animações.
"GesturingUp"	Para recuperar GesturingUp animações.
"Ocultar"	Para recuperar o Ocultando animações de estado.
"Audição"	Para recuperar o Audição animações de estado.
"Idling"	Para recuperar todas as animações de estado Idling.
"IdlingLevel1"	Para recuperar todas as animações IdlingLevel1.
"IdlingLevel2"	Para recuperar todas as animações IdlingLevel2.
"IdlingLevel3"	Para recuperar todas as animações IdlingLevel3.
"Ouvir"	Para recuperar as animações de estado Escuta.
"Moving"	Para recuperar todas as animações de estado Moving.
"MovingDown"	Para recuperar todas as animações Moving.
"MovingLeft"	Para recuperar todas as animações MovingLeft.
"MovingRight"	Para recuperar todas as animações MovingRight.
"MovingUp"	Para recuperar todas as animações MovingUp.
"Mostrando"	Para recuperar o Mostrando animações de estado.
"Speaking"	Para recuperar o Falando animações de estado.

Para . WAV, defina bszName para a URL ou especificação de arquivo para o . Arquivo WAV. Se a especificação não estiver completa, ela será interpretada como sendo relativa à especificação usada no método Load.

bQueue

Um booleano especificando se o servidor enfileira a solicitação Preparar. True enfileira a solicitação e faz com que qualquer solicitação de animação que a siga aguarde até que os dados de animação especificados sejam carregados. False recupera os dados da animação de forma assíncrona.

pdwReqID

Endereço de uma variável que recebe a ID de solicitação Preparar.

Se você carregar um caractere usando o protocolo HTTP (um arquivo . ACF), você deve usar o método Prepare para recuperar dados de animação antes de poder reproduzir a animação. Você não pode usar esse método se você carregou o caractere usando o protocolo UNC (um arquivo . ACS). Também não é possível recuperar dados HTTP para um caractere usando Preparar se você carregou esse caractere usando o protocolo UNC (. Arquivo de caracteres ACS).

Os dados de animação ou som recuperados com o método Prepare são armazenados no cache do navegador. As chamadas subsequentes verificarão o cache e, se os dados de animação já estiverem lá, o controle carregará os dados diretamente do cache. Uma vez carregados, os dados de animação ou som podem ser reproduzidos com os métodos Play ou Speak.

Você pode especificar várias animações e estados separando-os por vírgulas. No entanto, não é possível misturar tipos no mesmo instrução Prepare.