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 especificados para el carácter especificado.

Syntax

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

Parte	Descripción
Type	Necesario. Valor de cadena que indica el tipo de datos de animación que se va a cargar. "Animación" Datos de animación de un personaje. "Estado" Datos de estado de un carácter. "WaveFile" Archivo de audio (para salida hablada) de un carácter.
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 definido para el carácter cuando se guarda con el Editor de caracteres del Agente de Microsoft. En el caso de los estados, se pueden usar los siguientes valores: "Gesturing" Para obtener todas las animaciones de estado Gesturing . "GesturingDown" Para obtener la animación GesturingDown . "GesturingLeft" Para obtener la animación GesturingLeft . "GesturingRight" Para obtener la animación GesturingRight . "GesturingUp" Para obtener la animación GesturingUp . "Ocultar" Para obtener la animación de estado Ocultar . "Audición" Para obtener la animación de estado de audición . "Idling" Para obtener todas las animaciones de estado de idling . "IdlingLevel1" Para obtener todas las animaciones idlingLevel1 . "IdlingLevel2" Para obtener todas las animaciones idlingLevel2 . "IdlingLevel3" Para obtener todas las animaciones idlingLevel3 . "Escuchando" Para obtener la animación de estado de escucha . "Mover" Para obtener todas las animaciones de estado en movimiento . "MoveDown" Para obtener la animación MoveDown . "MoveLeft" Para obtener la animación MovingLeft . "MoveRight" Para obtener la animación MoveRight . "MoveUp" Para obtener la animación MovingUp . "Mostrar" Para obtener la animación mostrar estado. "Hablando" Para obtener la animación de estado de habla . Puede especificar varias animaciones y estados separandolas con comas. Sin embargo, no se pueden mezclar tipos en la misma instrucción Get . "URL ofilespec" Especificación del sonido (. WAV o . Archivo LWV). Si la especificación no está completa, se interpreta como relativa a la especificación utilizada en el método Load .
Cola	Opcional. Expresión booleana que especifica si el servidor pone en cola la solicitud Get . True (valor predeterminado) Pone en cola la solicitud Get . Cualquier solicitud de animación que siga a la solicitud Get (para el mismo carácter) espera hasta que se carguen los datos de animación. Falso No pone en cola la solicitud Get .

Observaciones

Si carga un carácter mediante el protocolo HTTP (un . Archivo ACF), debe 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 cargó el carácter mediante el protocolo UNC (un . Archivo ACS). Tampoco puede recuperar datos HTTP para un carácter mediante Get si cargó ese carácter mediante el protocolo UNC (. Archivo de caracteres de ACS).

Si declara una referencia de objeto y la establece en este método, devuelve un objeto Request . Si la animación asociada no se carga, el servidor establece la propiedad Status del objeto Request en "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 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 .

Consulte también

Load (Método)