Partager via


IAgentCharacter::P lay

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

HRESULT Play(
   BSTR bszAnimation,  // name of an animation
   long * pdwReqID     // address of request ID
);

Lit l’animation spécifiée.

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

bszAnimation

Nom d’une animation.

pdwReqID

Adresse d’une variable qui reçoit l’ID de demande IAgentCharacter::P lay .

Le nom d’une animation est défini lorsque le caractère est compilé avec l’Éditeur de caractères de l’agent Microsoft. Avant de lire l’animation spécifiée, le serveur tente de lire l’animation Retour pour l’animation précédente (si une animation a été affectée).

Lorsque les données d’animation d’un caractère sont stockées sur l’ordinateur local de l’utilisateur, vous pouvez utiliser la méthode IAgentCharacter::P lay et spécifier le nom de l’animation. Lorsque vous utilisez le protocole HTTP pour accéder aux données d’animation, utilisez la méthode Prepare pour garantir la disponibilité de l’animation avant d’appeler cette méthode.

Voir aussi

IAgentCharacter::P repare