Événements d'animation | Documentation

Vous pouvez définir des marqueurs d'événements d'animation sur la durée et utiliser GetMarkerReachedSignal() pour détecter ces marqueurs pendant que l'animation s'exécute.

Par défaut, la piste d'événements n'est pas visible. Pour afficher la piste d'événements :

Naviguez à droite de la durée et cliquez sur l'icône des paramètres. Un menu contextuel s'affiche.
Sélectionnez Afficher les événements d'animation. Cela ouvre la barre Événements d'animation directement en dessous des contrôles multimédia et de lecture.

Créer des événements

Les marqueurs d'événements sont des indicateurs visuels du début d'un événement d'animation. Après avoir créé un marqueur d'événement, vous pouvez le déplacer à n'importe quel emplacement de trame sur la durée.

Pour créer un nouveau marqueur d'événement :

Naviguez à la durée, puis cliquez et faites glisser le curseur jusqu'à l'emplacement de la trame où l'événement doit se produire.
Naviguez vers la piste d'événements, puis cliquez sur le bouton Modifier les événements d'animation.
Dans la boîte de dialogue, cliquez sur + Ajouter un événement, puis entrez un nom d'événement.
OPTIONNEL
Dans le champ Paramètre, entrez une chaîne de paramètres pour l'événement.
Cliquez sur le bouton Enregistrer. Dans la barre d'événements à l'intérieur de la durée, un nouveau symbole de marqueur s'affiche à la position de la trame.

Détecter des événements

Pour détecter des événements d'animation dans un LocalScript, connectez une fonction à la fonction GetMarkerReachedSignal() de AnimationTrack. Par exemple :


local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Créer une nouvelle instance "Animation"
local walkAnim = Instance.new("Animation")
-- Définir son "AnimationId" sur l'ID d'actif d'animation correspondant
walkAnim.AnimationId = "rbxassetid://5432167890"

-- Charger l'animation dans l'animateur
local walkAnimTrack = animator:LoadAnimation(walkAnim)

-- Connecter l'événement "GetMarkerReachedSignal" à un keyframe nommé spécifique
walkAnimTrack:GetMarkerReachedSignal("FootStep"):Connect(function(paramString)
	print(paramString)
end)

Vous pouvez spécifier une valeur de Paramètre pour tout marqueur d'événement dans l'éditeur d'animation. Cela vous permet de passer une chaîne personnalisée (valeur unique, chaîne séparée par des virgules, etc.) à la méthode GetMarkerReachedSignal(), comme illustré par l'argument paramString dans l'exemple de code ci-dessus. Cette chaîne peut ensuite être analysée ou convertie, si nécessaire, et utilisée pour toute action que vous souhaitez effectuer dans l'événement.

Dupliquer des événements

Au fur et à mesure que vous créez des événements, ils deviennent disponibles pour une utilisation dans toute l'animation, pas seulement à la position de la trame où vous les avez initialement créés. Par exemple, vous pouvez créer un marqueur d'événement FootStep au moment où le pied gauche d'un personnage touche le sol, puis utiliser le même événement lorsque le pied droit du personnage touche le sol.

Pour dupliquer un événement :

Cliquez avec le bouton droit sur un marqueur d'événement dans la barre d'événements, puis sélectionnez Copier la sélection dans le menu contextuel.
Cliquez avec le bouton droit à un autre moment de la durée et sélectionnez Coller les événements. L'événement copié s'insère à la position temporelle la plus proche de l'endroit où vous cliquez.
OPTIONNEL
Si l'événement original utilise un paramètre mais que l'événement dupliqué doit utiliser un paramètre modifié, effectuez les étapes suivantes :
1. Cliquez avec le bouton droit sur le marqueur d'événement dupliqué et sélectionnez Modifier l'événement d'animation dans le menu contextuel. La boîte de dialogue Modifier les événements d'animation s'affiche.
2. Apportez vos modifications et cliquez sur le bouton Enregistrer.