IAgentCharacter::Prepare

[O Microsoft Agent foi preterido do Windows 7 em diante 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 de um caractere.

• 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 dado de animação a ser carregado, que deve ser um dos seguintes:

Valor	Descrição
const unsigned short PREPARE_ANIMATION = 0;	Dados de animação de um caractere.
const unsigned short PREPARE_STATE = 1;	Dados de estado de um caractere.
const unsigned short PREPARE_WAVE = 2	O arquivo de áudio de um caractere (.WAV ou .LWV) para saída falada.

bszName

O nome da animação ou do estado.

O nome da animação é baseado naquele definido para o caractere quando que foi salvo usando o editor de caracteres do Microsoft Agent.

No caso dos estados, o valor pode ser um dos seguintes:

	Descrição
"Gesturing"	Para recuperar todas as animações de estado Gesturing.
"GesturingDown"	Para recuperar animações GesturingDown.
"GesturingLeft"	Para recuperar animações GesturingLeft.
"GesturingRight"	Para recuperar animações GesturingRight.
"GesturingUp"	Para recuperar animações GesturingUp.
"Hiding"	Para recuperar as animações de estado Hiding.
"Hearing"	Para recuperar as animações de estado Hearing.
"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.
"Listening"	Para recuperar as animações de estado Listening.
"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.
"Showing"	Para recuperar as animações de estado Showing.
"Speaking"	Para recuperar as animações de estado Speaking.

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

bQueue

Um booliano que especifica se o servidor enfileira a solicitação Prepare. True enfileira a solicitação e faz com que qualquer solicitação de animação que a segue aguarde até que os dados de animação especificados sejam carregados. False recupera os dados de animação de forma assíncrona.

pdwReqID

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

Se você carregar um caractere usando o protocolo HTTP (um arquivo .ACF), deverá usar o método Prepare para recuperar dados de animação antes de poder reproduzir a animação. Não será possível usar esse método se tiver carregado o caractere usando o protocolo UNC (um arquivo .ACS). Você também não poderá recuperar dados HTTP para um caractere usando Prepare se tiver carregado o caractere usando o protocolo UNC (arquivo de caractere .ACS).

Os dados de animação ou som recuperados com o método Prepare são armazenados no cache do navegador. As chamadas subsequentes farão a verificação do cache e, se os dados de animação já estiverem presentes, o controle carregará os dados diretamente do cache. Depois de carregados, os dados de animação ou som poderão ser reproduzidos com os métodos Play ou Speak.

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