KeyframeSequence

Bu nesne bir animasyon için tüm Keyframes saklar, animasyonun döngüye alınıp alınmadığını belirler ve diğer animasyonlara karşı önceliğini belirler.

Bir Anahtar Çerçeve Sekansı nedir?

Roblox, bir animasyonun oynatımında kullandığı animasyon verilerini oluşturur, bir Anahtar Çerçeve Sekansı'ndan referans alınan Animation.AnimationId özelliğiyle.Her animasyon, içeride bir Anahtar Çerçeve Sekansına veya bir Eğrisel Animasyona atıfta bulunur.Ancak, genellikle Roblox Animasyon Editörü tarafından oluşturulsa da, Anahtar Çerçeve Sekansı diğer pluginler veya hatta manuel olarak da oluşturulabilir.Roblox'a yüklendikten sonra, Roblox, yüklenen Anahtar ÇerçeveSekansı'na referans vermek için bir İçerik Kimliği atar çektiği mülk için.

Not, çoğu durumda, animasyon editörü çoğu animasyon işlevini kapsadığından, Anahtar Çerçeve Sekanslarını manipüle etmenize gerek yoktur.Ancak, bazı durumlarda bir animasyon oluşturmak veya kendi eklentioluşturmak isteyebilirsiniz Script .Ancak, sadece Roblox Studio böyle bir şekilde oluşturulan bir Anahtar Çerçeve Sekansı kullanabilir.Böyle bir Anahtar Çerçeve Sekansı kullanmak istiyorsanız, aşağıda açıklanan şekilde Roblox'a yüklemeniz gerekecektir.

Anahtar Çerçeve Sekansı Özellikleri

KeyframeSequence.Priority ve KeyframeSequence.Loop sıra için öncelik ve döngü animasyon ayarlarını kaydedin.AnimationTrack özelliklerinin oynatma sırasında sonunda bu özellikleri üzerine yazabileceğini unutmayın.

Dizideki son , en yüksek özellik ile olan bir animasyonun uzunluğunu belirler.

Anahtar Çerçeve Sekansı Yapısı

Anahtar çerçeve sıraları Keyframes tutan bir konteyner olarak davranır.Anahtar kareler, oynatma sırasında aralara serpiştirilen bir 'anahtar' kareyi temsil eder ve animasyonda.

Anahtar kareler Poses. , her birine özel olarak animasyon yapılan her , iki parçayı birbirine bağlayan uygulananı içerir.Pozlar, adına karşılık gelen ile eşleşir ve verilerini bu aynı adı taşıyan parça olarak uygular.Bu nedenle, animasyonlar doğru çalışması için farklı parça isimlerine ihtiyaç duyar.

Pozlar, ortak hierarhiye dayalı bir yapı izler.Her birinin ebeveyni Pose , bağlı olduğu parçanın Pose 'sına karşılır.Pratikte, bu, pozların kök kısmından ayrıldığını ifade eder.Görsel bir örnek için aşağıya bakın.

Animasyon yaparken Anahtar Çerçeve Sekanslarını kullanmak

Deneyimde oynanabilmesi için önce Roblox'a Anahtar Çerçeve Sekansları yüklemeniz gerekir.Studio'da, Anahtar Çerçeve Sekansı'na sağ tıklayın ve 'Roblox'a Kaydet'e tıklayın.Alternatif olarak, Plugin:SaveSelectedToRoblox() işlevini kullanabilirsiniz.Her iki yöntem de animasyon yükleme penceresini açar ve anahtar kare sıralamanızı bir animasyon olarak yüklemenize izin verir.

Bazı durumlarda, Roblox sitesine yüklemeden önce bir Animasyonu önizlemek isteyebilirsiniz.KeyframeSequenceProvider:RegisterKeyframeSequence() kullanarak geçici bir kimlik oluşturabilirsiniz.Bu, yerelleştirilmiş animasyon testi için kullanılabilecek bir hash kimliği oluşturur.

Anahtar Çerçeve Sekanslarını Alma

Bazı durumlarda, mevcut yüklü bir Animasyona karşılık gelen Anahtar Çerçeve Sekansını indirmek isteyebilirsiniz.Bir animasyonu indirmek için AnimationClipProvider:GetAnimationClipAsync() kullanabilirsiniz.

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