IAgentCharacter::Prepare

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures 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
);

Récupère les données d'animation d'un personnage.

• Renvoie S_OK pour indiquer que l'opération a réussi. Lorsque la fonction revient, pdwReqID contient l'ID de la requête.

dwType

Une valeur indiquant le type de données d'animation à charger, qui doit être l'un des suivants :

Valeur	Description
const unsigned short PREPARE_ANIMATION = 0;	Données d'animation d'un personnage.
const unsigned short PREPARE_STATE = 1;	Données d'état d'un personnage.
const unsigned short PREPARE_WAVE = 2	Le fichier son d'un personnage (.WAV ou .LWV) pour la sortie vocale.

bszName

Le nom de l'animation ou de l'état.

Le nom de l'animation est basé sur celui défini pour le personnage lorsqu'il a été enregistré à l'aide de l'éditeur de caractères de Microsoft Agent.

Pour les états, la valeur peut être l'une des suivantes :

	Description
"Gesturing"	Pour récupérer toutes les animations de l'état Gesturing.
"GesturingDown"	Pour récupérer les animations GesturingDown.
"GesturingLeft"	Pour récupérer les animations GesturingLeft.
"GesturingRight"	Pour récupérer les animations GesturingRight.
"GesturingUp"	Pour récupérer les animations GesturingUp.
"Hiding"	Pour récupérer les animations de l'état Hiding
"Hearing"	Pour récupérer les animations de l'état Hearing
"Idling"	Pour récupérer toutes les animations de l'état Idling
"IdlingLevel1"	Pour récupérer toutes les animations IdlingLevel1.
"IdlingLevel2"	Pour récupérer toutes les animations IdlingLevel2.
"IdlingLevel3"	Pour récupérer toutes les animations IdlingLevel3.
"Listening"	Pour récupérer les animations de l'état Listening.
"Moving"	Pour récupérer toutes les animations de l'état Moving
"MovingDown"	Pour récupérer toutes les animations Moving.
"MovingLeft"	Pour récupérer toutes les animations MovingLeft.
"MovingRight"	Pour récupérer toutes les animations MovingRight.
"MovingUp"	Pour récupérer toutes les animations MovingUp.
"Showing"	Pour récupérer les animations d’état Showing.
"Speaking"	Pour récupérer les animations de l'état Speaking.

Pour les fichiers .WAV, définissez bszName sur l'URL ou la spécification du fichier .WAV. Si la spécification n'est pas complète, elle est interprétée comme étant relative à la spécification utilisée dans la méthode Load.

bQueue

Un booléen indiquant si le serveur met en attente la requête Prepare. True met la requête en file d'attente et fait en sorte que toute requête d'animation qui la suit attende que les données d'animation qu'elle spécifie soient chargées. False récupère les données d'animation de manière asynchrone.

pdwReqID

Adresse d'une variable qui reçoit l'ID de la requête Prepare.

Si vous chargez un personnage à l'aide du protocole HTTP (un fichier .ACF), vous devez utiliser la méthode Prepare pour récupérer les données d'animation avant de pouvoir jouer l'animation. Vous ne pouvez pas utiliser cette méthode si vous avez chargé le personnage à l'aide du protocole UNC (un fichier .ACS). Vous ne pouvez pas non plus récupérer les données HTTP d'un personnage à l'aide de la méthode Prepare si vous avez chargé ce personnage à l'aide du protocole UNC (fichier de caractères .ACS).

Les données d'animation ou de son récupérées à l'aide de la méthode Prepare sont stockées dans le cache du navigateur. Les appels suivants vérifieront le cache et, si les données d'animation s'y trouvent déjà, le contrôle chargera les données directement à partir du cache. Une fois chargées, les données animées ou sonores peuvent être jouées à l'aide des méthodes Play ou Speak.

Vous pouvez spécifier plusieurs animations et états en les séparant par des virgules. Toutefois, vous ne pouvez pas mélanger les types dans la même instruction Prepare.