Chargement des données de caractère et d’animation

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

Une fois que vous avez un pointeur vers l’interface IAgentEx , vous pouvez utiliser la méthode Load pour charger un caractère et récupérer son interface IAgentCharacterEx . Il existe trois possibilités différentes pour le chemin de chargement d’un caractère. Le premier est compatible avec Microsoft Agent 1.5, où le chemin spécifié est le chemin d’accès complet et le nom de fichier d’un fichier de caractères. La deuxième possibilité consiste à spécifier uniquement le nom de fichier, auquel cas Agent recherche dans son répertoire Chars. La dernière possibilité consiste à fournir un paramètre Variant vide qui entraîne le chargement du caractère par défaut.

   // Create a variant to store the filename of the character to load

   const LPWSTR kpwszCharacter = L"merlin.acs";

   VariantInit(&vPath);

   vPath.vt = VT_BSTR;
   vPath.bstrVal = SysAllocString(kpwszCharacter);

   // Load the character

   hRes = pAgentEx->Load(vPath, &lCharID, &lRequestID);

   // Get its IAgentCharacterEx interface

   hRes = pAgentEx->GetCharacterEx(lCharID, &pCharacterEx);

Vous pouvez utiliser cette interface pour accéder aux méthodes du caractère :

   // Show the character.  The first parameter tells Microsoft
   // Agent to show the character by playing an animation.

   hRes = pCharacterEx->Show(FALSE, &lRequestID);

   // Make the character speak

   bszSpeak = SysAllocString(L"Hello World!");

   hRes = pCharacterEx->Speak(bszSpeak, NULL, &lRequestID);

   SysFreeString(bszSpeak);

Lorsque vous n’avez plus besoin de services Microsoft Agent, par exemple lorsque votre application cliente s’arrête, libérez ses interfaces. Notez que la libération de l’interface de caractères ne décharge pas le caractère. Appelez la méthode Unload pour effectuer cette opération avant de libérer l’interface IAgentEx :

// Clean up

if (pCharacterEx) {

   // Release the character interface

   pCharacterEx->Release();

   // Unload the character.  NOTE:  releasing the character
   // interface does NOT make the character go away.  You must
   // call Unload.

   pAgentEx->Unload(lCharID);
}
   
// Release the Agent

pAgentEx->Release();

VariantClear(&vPath);