IAgentCharacter::P repare

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de 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 los datos de animación de un carácter.

• Devuelve S_OK para indicar que la operación se realizó correctamente. Cuando se devuelve la función, pdwReqID contiene el identificador de la solicitud.

dwType

Valor que indica el tipo de datos de animación que se va a cargar, que debe ser uno de los siguientes:

Valor	Descripción
const unsigned shortPREPARE_ANIMATION = 0;	Datos de animación de un personaje.
const unsigned shortPREPARE_STATE = 1;	Datos de estado de un carácter.
const unsigned shortPREPARE_WAVE = 2	Archivo de sonido de un carácter (. WAV o . LWV) para la salida hablada.

bszName

Nombre de la animación o el estado.

El nombre de la animación se basa en el definido para el carácter cuando se guardó mediante el Editor de caracteres del Agente de Microsoft.

Para los estados, el valor puede ser uno de los siguientes:

	Descripción
"Gesturing"	Para recuperar todas las animaciones de estado Gesturing .
"GesturingDown"	Para recuperar animaciones GesturingDown .
"GesturingLeft"	Para recuperar animaciones GesturingLeft .
"GesturingRight"	Para recuperar animaciones GesturingRight .
"GesturingUp"	Para recuperar animaciones GesturingUp .
"Ocultar"	Para recuperar las animaciones de estado Ocultar .
"Audición"	Para recuperar las animaciones de estado De audición .
"Idling"	Para recuperar todas las animaciones de estado de idling .
"IdlingLevel1"	Para recuperar todas las animaciones IdlingLevel1 .
"IdlingLevel2"	Para recuperar todas las animaciones IdlingLevel2 .
"IdlingLevel3"	Para recuperar todas las animaciones IdlingLevel3 .
"Escuchando"	Para recuperar las animaciones de estado de escucha .
"Mover"	Para recuperar todas las animaciones de estado en movimiento.
"MoveDown"	Para recuperar todas las animaciones en movimiento .
"MoveLeft"	Para recuperar todas las animaciones MovingLeft .
"MoveRight"	Para recuperar todas las animaciones MovingRight .
"MoveUp"	Para recuperar todas las animaciones MovingUp .
"Mostrar"	Para recuperar las animaciones de estado Que se muestran .
"Hablando"	Para recuperar las animaciones de estado de habla .

Para. Archivos WAV, establezca bszName en la dirección URL o especificación de archivo para . Archivo WAV. Si la especificación no está completa, se interpreta como relativa a la especificación usada en el método Load .

bQueue

Valor booleano que especifica si el servidor pone en cola la solicitud de preparación . True pone en cola la solicitud y hace que cualquier solicitud de animación que la sigue espere hasta que se carguen los datos de animación que especifica. False recupera los datos de animación de forma asincrónica.

pdwReqID

Dirección de una variable que recibe el identificador de solicitud de preparación .

Si carga un carácter mediante el protocolo HTTP (un . Archivo ACF), debes usar el método Prepare para recuperar datos de animación antes de poder reproducir la animación. No puede usar este método si cargó el carácter mediante el protocolo UNC (un . Archivo ACS). Tampoco puede recuperar datos HTTP para un carácter mediante Prepare si cargó ese carácter mediante el protocolo UNC (. Archivo de caracteres de ACS).

Los datos de animación o sonido recuperados con el método Prepare se almacenan en la memoria caché del explorador. Las llamadas posteriores comprobarán la memoria caché y, si los datos de animación ya están allí, el control carga los datos directamente desde la memoria caché. Una vez cargados, los datos de animación o sonido se pueden reproducir con los métodos Play o Speak .

Puedes especificar varias animaciones y estados separandolas con comas. Sin embargo, no se pueden mezclar tipos en la misma instrucción Prepare .