Animation d’un caractère

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

Une fois qu’un caractère est chargé, vous pouvez utiliser plusieurs méthodes de Microsoft Agent pour animer le caractère. Le premier que vous utilisez est généralement la méthode Show. Show rend la trame du personnage visible et joue l'animation assignée à l'état Showing du personnage.

Une fois que le cadre du personnage est visible, vous pouvez utiliser la méthode Lire, en spécifiant le nom d’une animation, pour lire cette animation. Les noms d’animation sont spécifiques à une définition de caractère. Pendant qu'une animation se joue, la forme de la fenêtre change pour correspondre à l'image de la scène. Il en résulte une image graphique mobile, ou sprite, affichée au-dessus du bureau et de toutes les fenêtres, ou ordre z.

Si le fichier du caractère est stocké localement, vous pouvez simplement appeler la méthode Play. Dans d'autres cas, par exemple lorsque vous avez chargé un .ACF à partir d'un serveur HTTP, vous devez utiliser la méthode Get (ou Prepare) pour d'abord récupérer les données d'animation. Cela amènera l'Agent à demander le fichier d'animation au serveur et à le stocker dans la mémoire tampon du navigateur sur l'ordinateur local.

La méthode Speak vous permet de programmer le personnage à parler, effectuant automatiquement la synchronisation labiale de la sortie. Vous trouverez plus d’informations dans la section Sortie de ce document.

Vous pouvez utiliser la méthode MoveTopour positionner le caractère à un nouvel emplacement. Lorsque vous appelez la méthode MoveTo, Microsoft Agent joue automatiquement l'animation appropriée en fonction de l'emplacement actuel du personnage, puis déplace la trame du personnage. De même, lorsque vous appelez GestureAt, Microsoft Agent joue l’animation gestuelle appropriée en fonction de la position du personnage et de la position spécifiée dans l’appel.

Pour masquer le caractère, appelez la méthode Masquer. Cela permet de jouer automatiquement le personnage associé à l'état Hiding du personnage, puis de cacher la trame du personnage. Toutefois, vous pouvez également masquer ou afficher un caractère en définissant la propriété Visible du caractère.

Microsoft Agent traite tous les appels d’animation, ou demandes , de manière asynchrone. Cela permet au code de votre application de continuer à gérer d’autres événements pendant le traitement de la demande. Par exemple, les appels à la méthode Play placent l’animation dans une file d’attente pour le personnage afin que les animations puissent être exécutées de manière séquentielle. Toutefois, cela signifie que vous ne pouvez pas supposer qu’un appel à d’autres fonctions s’exécute nécessairement après une animation qu’elle suit dans votre code. Par exemple, en règle générale, une instruction suivant un appel à Play ou MoveTo s’exécute avant la fin de l’animation.

Vous pouvez synchroniser votre code avec les animations dans la file d'attente d'un personnage en créant une référence à l'objet de la demande d'animation et, lorsque l'animation démarre ou se termine, en surveillant les événements Demande que le serveur utilise pour informer les clients du personnage. Par exemple, si vous souhaitez qu’une boîte de message s’affiche lorsque le caractère termine une animation, vous pouvez placer l’appel de la boîte de message dans votre RequestComplete sous-routine de gestion des événements, en vérifiant l’ID de requête particulier.

Lorsqu'un personnage est masqué, le serveur ne joue pas d'animations ; cependant, il met toujours en file d'attente et exécute la demande d'animation et transmet un statut de la requête au client. Dans l’état masqué, le caractère ne peut pas devenir actif en entrée. Toutefois, si l’utilisateur parle le nom du caractère (lorsque l’entrée vocale est activée), le serveur affiche automatiquement le caractère.

Lorsque votre application cliente charge plusieurs personnages en même temps, les services d'animation de Microsoft Agent vous permettent d'animer des personnages indépendamment ou d'utiliser les méthodes Attente, Interrompre, ou Arrêter pour synchroniser leur animation entre elles.

Microsoft Agent joue également d'autres animations automatiquement pour vous. Par exemple, si l'état du personnage n'a pas changé pendant plusieurs secondes, l'agent commence à jouer les animations affectées aux animations Idling du personnage. De même, lorsque la saisie vocale est activée, l'agent joue les animations Listening du personnage, puis les animations Hearing lorsqu'une parole est détectée. Ces animations gérées par le serveur sont appelées étatset sont définies lorsqu’un personnage est créé. Pour plus d’informations, consultez Conception de caractères pour Microsoft Agent.