Get, méthode

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

Description

Récupère les données d'animation spécifiées pour le personnage spécifié.

Syntaxe

agent**.Characters ("CharacterID").Get** Type, Name, [Queue]

Élément	Description
Type	Obligatoire. Une chaîne de caractères indiquant le type de données d'animation à charger. "Animation" Données d’animation d’un personnage. " State" Données d’état d’un personnage. "WaveFile" Fichier audio d'un personnage (pour la synthèse vocale).
Nom	Obligatoire. Une chaîne qui indique le nom du type d'animation. "name" Le nom de l'animation ou de l'état. Pour les animations, le nom est basé sur celui défini pour le personnage lorsqu'il est enregistré à l'aide de l'éditeur de personnage de Microsoft Agent. Pour les états, les valeurs suivantes peuvent être utilisées : « Gesturing » Pour obtenir toutes les animations d’état Gesturing. « GesturingDown » Pour obtenir l’animation GesturingDown . « GesturingLeft » Pour obtenir l’animation GesturingLeft . « GesturingRight » Pour obtenir l’animation GesturingRight . « GesturingUp » Pour obtenir l’animation GesturingUp . "Hiding" Pour obtenir l'animation de l'état "Hiding". "Hearing" Pour obtenir l'animation de l'état "Hearing". "Idling" Pour obtenir toutes les animations Idling "IdlingLevel1" Pour obtenir toutes les animations IdlingLevel1. "IdlingLevel2" Pour obtenir toutes les animations IdlingLevel2. "IdlingLevel2" Pour obtenir toutes les animations IdlingLevel3. "Listening" Pour obtenir l’animation de l’état Listening. "Moving" Pour obtenir toutes les animations de l'état Moving. "MovingDown" Pour obtenir l'animation MovingDown. " MovingLeft" Pour obtenir l’animation MovingLeft. "MovingRight" Pour obtenir l’animation MovingRight. " MovingUp" Pour obtenir l’animation MovingUp. " Affichage" Pour obtenir l’animation d’état d’affichage. " Speaking" Pour obtenir l’animation de l’état Speaking. 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 Get. "URL ou filespec" Spécification du fichier son (.WAV ou .LWV). 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
File d’attente	facultatif. Expression booléenne indiquant si le serveur met en file d'attente la requête Get. True (par défaut) Met la requête Get en file d'attente. Toute requête d'animation qui suit la requête Get (pour le même personnage) attend que les données d'animation soient chargées. False Ne met pas la requête Get en file d'attente.

Notes

Si vous chargez un personnage à l'aide du protocole HTTP (fichier .ACF), vous devez utiliser la méthode Get pour récupérer les données d'animation avant de pouvoir jouer l'animation. Vous n'utilisez pas 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 Get si vous avez chargé ce personnage à l'aide du protocole UNC (fichier de caractères .ACS).

Si vous déclarez une référence d'objet et que vous l'affectez à cette méthode, celle-ci renvoie un objet Request. Si le chargement de l'animation associée échoue, le serveur attribue à la propriété Status de l'objet Request la valeur « failed » et un numéro d'erreur approprié. Vous pouvez utiliser l'événement RequestComplete pour vérifier l'état et déterminer l'action à entreprendre.

Les données d'animation ou de son récupérées à l'aide de la méthode Get 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 d'animation ou de son peuvent être jouées à l'aide des méthodes Play ou Speak.

Voir aussi

Charger une méthode