Partager via


IAgentCharacter ::P lay

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible 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 est retournée, pdwReqID contient l’ID de la requête.

bszAnimation

Nom d’une animation.

pdwReqID

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

Le nom d’une animation est défini lorsque le caractère est compilé avec l’éditeur de caractères Microsoft Agent. 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