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 caractère spécifié.

Syntaxe

agent**. Caractères (« CharacterID »). Get** Type, Name, [File d’attente]

Élément	Description
Type	Obligatoire. Valeur de chaîne qui indique le type de données d’animation à charger. « Animation » Données d’animation d’un caractère. « État » Données d’état d’un caractère. « WaveFile » Fichier audio d’un caractère (pour la sortie parlée).
Nom	Obligatoire. Chaîne qui indique le nom du type d’animation. « name » Nom de l’animation ou de l’état. Pour les animations, le nom est basé sur celui défini pour le caractère lors de son enregistrement à l’aide de l’Éditeur de caractères de l’agent Microsoft. 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 . « Masquage » Pour obtenir l’animation d’état masquer . « Audition » Pour obtenir l’animation d’état d’audition . « Idling » Pour obtenir toutes les animations d’état d’idling . « IdlingLevel1 » Pour obtenir toutes les animations IdlingLevel1 . « IdlingLevel2 » Pour obtenir toutes les animations IdlingLevel2 . « IdlingLevel3 » Pour obtenir toutes les animations IdlingLevel3 . « Écoute » Pour obtenir l’animation d’état d’écoute . « Déplacement » Pour obtenir toutes les animations d’état de déplacement . « 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 Affichage de l’état. « Parler » Pour obtenir l’animation d’état Parler . 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 oufilespec » Spécification du son (. WAV ou . Fichier LWV). Si la spécification n’est pas terminée, elle est interprétée comme étant relative à la spécification utilisée dans la méthode Load .
File d'attente	Optionnel. Expression booléenne spécifiant si le serveur met en file d’attente la requête Get . True (valeur par défaut) met en file d’attente la requête Get . Toute demande d’animation qui suit la demande Get (pour le même caractère) attend que les données d’animation soient chargées. Faux Ne met pas en file d’attente la demande Get .

Notes

Si vous chargez un caractère à l’aide du protocole HTTP (un . Fichier ACF), vous devez utiliser la méthode Get pour récupérer les données d’animation avant de pouvoir lire l’animation. Vous n’utilisez pas cette méthode si vous avez chargé le caractère à l’aide du protocole UNC (un . Fichier ACS). Vous ne pouvez pas non plus récupérer les données HTTP d’un caractère à l’aide de Get si vous avez chargé ce caractère à l’aide du protocole UNC (. Fichier de caractères ACS).

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 . Si l’animation associée ne parvient pas à se charger, le serveur définit la propriété Status de l’objet Request sur « échec » avec un numéro d’erreur approprié. Vous pouvez utiliser l’événement RequestComplete pour case activée le status et déterminer l’action à entreprendre.

Les données d’animation ou de son récupérées avec la méthode Get sont stockées dans le cache du navigateur. Les appels suivants case activée le cache et, si les données d’animation sont déjà présentes, le contrôle charge les données directement à partir du cache. Une fois chargées, les données d’animation ou de son peuvent être lues avec les méthodes Play ou Speak .

Voir aussi

Load, méthode