KeyframeSequence

Cet objet stocke tous les Keyframes pour une animation, détermine si l'animation est en boucle et détermine sa priorité par rapport à d'autres animations.

Qu'est-ce qu'une séquence de clés?

Roblox construit les données d'animation qu'il utilise dans le playback d'une animations, référencées par la propriété Animation.AnimationId d'un KeyframeSequence. Chaque animation réfère à un KeyframeSequenc

Remarquez que, dans la plupart des cas, vous n'avez pas besoin de manipuler les séquences de clés, car l'éditeur d'animation couvre la plupart des fonctionnalités d'animation. Cependant, dans certains cas, vous voudrez peut-être générer une animation à partir d'un Script ou construire votre propre plugin. Cependant, seuls Roblox Studio et Roblox Studio peuvent utiliser une séquence de clés cré

Propriétés de la séquence de clés

KeyframeSequence.Priority et KeyframeSequence.Loop enregistrent les paramètres de priorité et d'animation en boucle pour la séquence. Remarquez que les propriétés AnimationTrack peuvent finalement écraser ces propriétés au moment de l'exécution.

Le dernier Keyframe dans la séquence, ce qui signifie le Keyframe avec la plus haute propriété Keyframe.Time, détermine la longueur d'une animations.

Structure de la séquence clé

Les séquences de clés agissent comme un conteneur qui contient Keyframes . Les séquences de clés représentent un cadre « clé » dans l'animations, qui sont interpolaires pendant la lecture.

Les keyframes contiennent Poses . Class.Pose|Poses

Les poses suivent une structure basée sur la hiérarchie jointe. Le parent de chaque Pose correspond à la hiérarchie Pose de la partie à laquelle il est associé. Dans la pratique, cela signifie que les poses se déploient à partir de la racine. Voir ci-dessous pour un exemple visuel.

Utiliser les séquences clé lors de l'animation

Vous devez d'abord télécharger les séquences clé pour Roblox avant qu'elles puissent être jouées dans une expérience. Dans Studio, cliquez avec le bouton droit sur la séquence clé et cliquez sur «Enregistrer dans Roblox». Alternativement, vous pouvez utiliser la fonction Plugin:SaveSelectedToRoblox(). Elle ouvrira la fenêtre de téléchargement des animations et vous permettra de télécharger votre séquence clé en tant qu'animation.

Dans certains cas, vous voudrez peut-être prévisualiser une animation avant de la télécharger sur le site Roblox. Vous pouvez générer un identifiant temporaire en utilisant KeyframeSequenceProvider:RegisterKeyframeSequence(). Cela générera un identifiant de hachage qui peut être utilisé pour les tests d'animation localisés.

Obtention de séquences de clés

Dans certains cas, vous voudrez peut-être télécharger la séquence de clés correspondant à une animation existante. Vous pouvez utiliser AnimationClipProvider:GetAnimationClipAsync() pour télécharger une animations.

local function getSequenceLength(keyframeSequence)
	local length = 0
	for _, keyframe in pairs(keyframeSequence:GetKeyframes()) do
		if keyframe.Time > length then
			length = keyframe.Time
		end
	end
	return length
end

local keyframeSequence = Instance.new("KeyframeSequence")

getSequenceLength(keyframeSequence)

local KeyframeSequenceProvider = game:GetService("KeyframeSequenceProvider")

local function createPreviewAnimation(keyframeSequence)
	local hashId = KeyframeSequenceProvider:RegisterKeyframeSequence(keyframeSequence)
	local Animation = Instance.new("Animation")
	Animation.AnimationId = hashId
	return Animation
end

local keyframeSequence = Instance.new("KeyframeSequence")

local animation = createPreviewAnimation(keyframeSequence)

print(animation)

-- create the keyframesequence
local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Loop = false
keyframeSequence.Priority = Enum.AnimationPriority.Action

--  create a keyframe
local keyframe = Instance.new("Keyframe")
keyframe.Time = 0

-- create sample poses
local rootPose = Instance.new("Pose")
rootPose.Name = "HumanoidRootPart"
rootPose.Weight = 0

local lowerTorsoPose = Instance.new("Pose")
lowerTorsoPose.Name = "LowerTorso"
lowerTorsoPose.Weight = 1

-- set the sequence hierarchy
rootPose:AddSubPose(lowerTorsoPose) -- lowerTorsoPose.Parent = rootPose
keyframe:AddPose(rootPose) -- rootPose.Parent = keyframe
keyframeSequence:AddKeyframe(keyframe) -- keyframe.Parent = keyframeSequence

-- parent the sequence
keyframeSequence.Parent = workspace