KeyframeSequence

Este objeto almacena todo el Keyframes para una animación, determina si la animación se repite, y determina su prioridad contra otras animaciones.

¿Qué es una secuencia de marcos clave?

Roblox construye los datos de animación que usa en la reproducción de una animaciones, referenciados por la propiedad Animation.AnimationId de una secuencia clave.Cada animación se refiere a una Secuencia de marcos clave o a una animación de curva internamente.Aunque, por lo general, creado por el Editor de animación de Roblox, KeyframeSequence también se puede crear por otros plugins o incluso manualmente.Una vez subido a Roblox, Roblox asigna un ID de contenido que Animations use para la propiedad Animation.AnimationId para referirse a la secuencia de claves subida.

Tenga en cuenta que, en la mayoría de los casos, no necesita manipular las secuencias de marco clave, ya que el editor de animaciones cubre la mayoría de la funcionalidad de animación.Sin embargo, en algunos casos es posible que desees generar una animación desde un Script o construir tu propio complemento.Sin embargo, solo Roblox Studio puede usar una secuencia de marcos clave creada de esa manera.Si desea utilizar una secuencia de marco de clave como esta, deberá subirla a Roblox como se describe a continuación.

Propiedades de la secuencia de marcos clave

KeyframeSequence.Priority y KeyframeSequence.Loop guarda las configuraciones de prioridad y animación en bucle para la secuencia.Tenga en cuenta que las propiedades AnimationTrack pueden eventualmente reemplazar estas propiedades al momento de reproducción.

El último Keyframe en la secuencia, lo que significa que el Keyframe con la propiedad más alta Keyframe.Time determina la duración de una animaciones.

Estructura de KeyframeSequence

Las secuencias de marco clave actúan como un contenedor que contiene Keyframes .Los marcos clave representan un marco clave en la animaciones, que se interpola entre durante la reproducción.

Los marcos de clave contienen Poses . Poses , específico para cada BasePart que se está animando, contiene el CFrame aplicado al Motor6D que conecta dos partes.Las poses coinciden con las BasePart que correspondan por nombre y aplican sus datos a la Motor6D con esta parte de nombre similar identificada como Motor6D.P1 .Por esta razón, las animaciones requieren nombres de partes distintos para jugar correctamente.

Las poses siguen una estructura basada en la jerarquía conjunta.El padre de cada Pose corresponde al Pose de la parte a la que se le adjunta.En la práctica, esto significa que la rama de poses se ramifica desde la parte raíz.Vea a continuación un ejemplo visual.

Usar secuencias de marco clave al hacer animaciones

Debes subir primero las secuencias de marco de clave a Roblox antes de que se puedan reproducir en una experiencia.En Studio, haz clic derecho en la secuencia de marcos clave y haz clic en 'Guardar en Roblox'.Alternativamente, puedes usar la función Plugin:SaveSelectedToRoblox().Cualquiera de los métodos mostrará la ventana de subida de animación y te permitirá subir tu KeyframeSequence como una animaciones.

En algunos casos, es posible que desees previsualizar una animación antes de subirla al sitio de Roblox.Puedes generar una identificación temporal usando KeyframeSequenceProvider:RegisterKeyframeSequence().Esto generará una identificación de hash que se puede utilizar para las pruebas de animación localizadas.

Obtención de secuencias de marco clave

En algunos casos, es posible que desees descargar la secuencia de marcos clave correspondiente a una animación subida existente.Puedes usar AnimationClipProvider:GetAnimationClipAsync() para descargar una animaciones.

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