KeyframeMarker

Un marqueur de cadre clé est une instance destinée à représenter un événement qui sera finalement déclenché lorsqu'un Keyframe est frappé.

Utiliser un marqueur de cadre clé

Les marqueurs de cadre clé doivent toujours être parentés à un cadre clé en définissant le parent directement ou en utilisant la fonction Keyframe:AddMarker() du cadre clé.Les marqueurs de cadre clé peuvent également être supprimés directement ou en utilisant la fonction Keyframe:RemoveMarker(), et interrogés pour vérifier quels marqueurs sont attachés à un cadre clé spécifique en utilisant Keyframe:GetMarkers().

Chaque fois qu'un cadre clé est détecté comme une animation est en cours d'exécution, il y aura un événement déclenché pour chaque marqueur de cadre clé qui est parent du cadre clé.Ces événements sont identifiables par le nom du marqueur Keyframe.Vous pouvez récupérer et écouter ces événements en utilisant la fonction AnimationTrack.GetKeyframeMarkerReached.Facultativement, vous pouvez définir la propriété KeyframeMarker.Value de la marque-clé dans le but de transmettre une valeur avec l'événement déclenché.

Il hérite la propriété Keyframe.Name de Instance et se comporte identiquement.Les noms sont utilisés pour l'identification et n'ont pas besoin d'être uniques.Lorsque plusieurs instances KeyframeMarker avec le même nom sont attachées à un Keyframe, des événements tels que ceux retournés par AnimationTrack:GetMarkerReachedSignal() se déclencheront pour chaque marqueur.

Voir aussi :

• Keyframe , maintient le Poses appliqué aux jointures dans un Model à un point donné dans une animations
• AnimationTrack , contrôle la lecture d'une animation sur un Humanoid ou AnimationController
• Animation , contient une référence aux données d'animation requises pour jouer des animations personnalisées sur des personnages ou d'autres modèles en utilisant le système d'animation Roblox

local keyframe = Instance.new("Keyframe")
keyframe.Parent = workspace

local marker1 = Instance.new("KeyframeMarker")
marker1.Name = "FootStep"
marker1.Value = 100

local marker2 = Instance.new("KeyframeMarker")
marker2.Name = "Wave"
marker2.Value = 100

keyframe:AddMarker(marker1) --marqueur.Parent = keyframe
keyframe:AddMarker(marker2) --marqueur.Parent = keyframe

local markers = keyframe:GetMarkers()
for _, marker in pairs(markers) do
	print(marker.Name)
end

local Players = game:GetService("Players")

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

-- Create new "Animation" instance
local kickAnimation = Instance.new("Animation")
-- Set its "AnimationId" to the corresponding animation asset ID
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Load animation onto the humanoid
local kickAnimationTrack = humanoid:LoadAnimation(kickAnimation)

-- Play animation track
kickAnimationTrack:Play()

-- If a named event was defined for the animation, connect it to "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)