Aprenda
Classe do mecanismo
KeyframeSequence

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Métodos
AddKeyframe(keyframe: Instance):()
RemoveKeyframe(keyframe: Instance):()
Membros herdados
Amostras de código
Obter Comprimento de KeyframeSequence
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)
Instanciação de Sequência de Quadro-Chave
-- Crie a sequência
local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Loop = false
keyframeSequence.Priority = Enum.AnimationPriority.Action
-- Crie um quadro-chave
local keyframe = Instance.new("Keyframe")
keyframe.Time = 0
-- Crie poses de exemplo
local rootPose = Instance.new("Pose")
rootPose.Name = "HumanoidRootPart"
rootPose.Weight = 0
local lowerTorsoPose = Instance.new("Pose")
lowerTorsoPose.Name = "LowerTorso"
lowerTorsoPose.Weight = 1
-- Defina a hierarquia da sequência
rootPose:AddSubPose(lowerTorsoPose)
keyframe:AddPose(rootPose)
keyframeSequence:AddKeyframe(keyframe)
-- Defina o pai da sequência
keyframeSequence.Parent = workspace

Referência API
Propriedades
AuthoredHipHeight
Oculto
Segurança do plugin
Ler Parallel
Recursos: Animation
KeyframeSequence.AuthoredHipHeight:number

Métodos
AddKeyframe
Recursos: Animation
KeyframeSequence:AddKeyframe(keyframe:Instance):()
Parâmetros
keyframe:Instance
Devolução
()
Amostras de código
Instanciação de Sequência de Quadro-Chave
-- Crie a sequência
local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Loop = false
keyframeSequence.Priority = Enum.AnimationPriority.Action
-- Crie um quadro-chave
local keyframe = Instance.new("Keyframe")
keyframe.Time = 0
-- Crie poses de exemplo
local rootPose = Instance.new("Pose")
rootPose.Name = "HumanoidRootPart"
rootPose.Weight = 0
local lowerTorsoPose = Instance.new("Pose")
lowerTorsoPose.Name = "LowerTorso"
lowerTorsoPose.Weight = 1
-- Defina a hierarquia da sequência
rootPose:AddSubPose(lowerTorsoPose)
keyframe:AddPose(rootPose)
keyframeSequence:AddKeyframe(keyframe)
-- Defina o pai da sequência
keyframeSequence.Parent = workspace

GetKeyframes
Recursos: Animation
KeyframeSequence:GetKeyframes():{Keyframe}
Devolução
Amostras de código
Obter Comprimento de KeyframeSequence
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)

RemoveKeyframe
Recursos: Animation
KeyframeSequence:RemoveKeyframe(keyframe:Instance):()
Parâmetros
keyframe:Instance
Devolução
()
Amostras de código
SequênciaDeQuadros RemoverQuadro
local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Parent = workspace
local keyframe = Instance.new("Keyframe")
keyframeSequence:AddKeyframe(keyframe)
task.wait(2)
keyframeSequence:RemoveKeyframe(keyframe)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.