Get (Método)

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

Descripción

Recupera los datos de animación indicados para el personaje correspondiente.

Sintaxis

agent**.Characters ("CharacterID").Get** Type, Name, [Queue]

Parte	Descripción
Tipo	Necesario. Valor de cadena que indica el tipo de datos de animación que se va a cargar. "Animation" Datos de animación de un personaje. "State" Datos de estado de un personaje. "WaveFile" Archivo de audio de un personaje (para salida de voz).
Nombre	Obligatorio. Cadena que indica el nombre del tipo de animación. "name" El nombre de la animación o el estado. En el caso de las animaciones, el nombre se basa en el que se haya definido para el personaje cuando se guarda con el Editor de personajes del Microsoft Agent (Microsoft Agent Character Editor). En el caso de los estados, se pueden usar los valores siguientes: "Gesturing" Para obtener todas las animaciones de estado Gesturing (gestos). "GesturingDown" Para obtener la animación GesturingDown (gesto hacia abajo). "GesturingLeft" Para obtener la animación GesturingLeft (gesto hacia la izquierda). "GesturingRight" Para obtener la animación GesturingRight (gesto hacia la derecha). "GesturingUp" Para obtener la animación GesturingUp (gesto hacia arriba). "Hiding" Para obtener la animación de estado Hiding (ocultar). "Hearing" Para obtener la animación de estado Hearing (oír). "Idling" Para obtener todas las animaciones de estado Idling (inactivo). "IdlingLevel1" Para obtener todas las animaciones IdlingLevel1. "IdlingLevel2" Para obtener todas las animaciones IdlingLevel2. "IdlingLevel3" Para obtener todas las animaciones IdlingLevel3. "Listening" Para obtener la animación de estado Listening (escuchar). "Moving" Para obtener todas las animaciones de estado Moving (moverse). "MovingDown" Para obtener la animación MovingDown (moverse hacia abajo). "MoveLeft" Para obtener la animación MovingLeft (moverse a la izquierda). "MoveRight" Para obtener la animación MoveRight (moverse a la derecha). "MovingUp" Para obtener la animación MovingUp (moverse hacia arriba). "Showing" Para obtener la animación de estado Showing (aparecer). "Speaking" Para obtener la animación de estado Speaking (hablar). Puede indicar varias animaciones y estados separándolas con comas. Sin embargo, no se pueden mezclar tipos en la misma instrucción Get. "URL o filespec" La especificación del archivo de sonido (.WAV o .LWV). Si la especificación no está completa, se interpreta como relativa a la especificación usada en el método Load.
Queue	Opcional. Expresión booleana que indica si el servidor pone en cola la solicitud Get. True (predeterminado) Pone en cola la solicitud Get. Cualquier solicitud de animación que siga a la solicitud Get (para el mismo personaje) queda en espera hasta que se carguen los datos de animación. False No pone en cola la solicitud Get.

Comentarios

Si carga un personaje mediante el protocolo HTTP (archivo .ACF), deberá usar el método Get para recuperar los datos de animación antes de poder reproducir la animación. No use este método si ha cargado el personaje mediante el protocolo UNC (archivo .ACS). Tampoco puede recuperar datos HTTP de un personaje mediante Get si ha cargado este personaje mediante el protocolo UNC (archivo de personaje .ACS).

Si declara una referencia de objeto y la crea en este método, se devolverá el objeto Request. Si la animación asociada no se puede cargar, el servidor cambiará en el objeto Request la propiedad Status a "failed" con un número de error adecuado. Puede usar el evento RequestComplete para comprobar el estado y determinar qué acción realizar.

Los datos de animación o sonido recuperados con el método Get 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 cargará los datos directamente de la memoria caché. Una vez cargados, los datos de animación o sonido se podrán reproducir con los métodos Play o Speak.

Consulte también

Load (Método)