Lire en anglais

Partager via


Play, méthode (fonctionnalités d’environnement Windows héritées)

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

Description

Lit l’animation spécifiée pour le caractère spécifié.

Syntaxe

agent**. Caractères (« CharacterID »). Play** « AnimationName »

Élément Description
AnimationName Obligatoire. Chaîne qui spécifie le nom d’une séquence d’animation.

 

Notes

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 de l’animation précédente, si une animation a été affectée.

Lorsque vous accédez aux animations d’un personnage à l’aide d’un protocole de fichier conventionnel, vous pouvez simplement utiliser la méthode Play en spécifiant le nom de l’animation. Toutefois, si vous utilisez le protocole HTTP pour accéder aux données d’animation de caractères, utilisez la méthode Get pour charger l’animation avant d’appeler la méthode Play .

Pour plus d’informations, consultez la méthode Get .

Pour simplifier votre syntaxe, vous pouvez déclarer une référence d’objet et la définir pour référencer l’objet Character dans la collection Characters et utiliser la référence dans le cadre de vos instructions Play :

   Dim Genie   
   Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"

   Set Genie = Agent1.Characters ("Genie")
   
   Genie.Get "state", "Showing"
   Genie.Show

   Genie.Get "animation", "Greet, GreetReturn"
   Genie.Play "Greet"
   Genie.Speak "Hello."

Si vous déclarez une référence d’objet et que vous la définissez sur cette méthode, elle retourne un objet Request . En outre, si vous spécifiez une animation qui n’est pas chargée ou si le caractère n’a pas été correctement chargé, le serveur définit la propriété Status de l’objet Request sur « échec » avec un numéro d’erreur approprié. Toutefois, si l’animation n’existe pas et que les données du caractère ont déjà été correctement chargées, le serveur génère une erreur.

La méthode Play ne rend pas le personnage visible. Si le caractère n’est pas visible, le serveur lit l’animation de manière invisible et définit la propriété Status de l’objet Request .