KeyframeSequenceProvider

Metode

RegisterActiveKeyframeSequence(keyframeSequence : Instance):ContentId
Mem生成临时资源ID dari KeyframeSequence yang dapat digunakan untuk tes lokalisasi animasi. Mem生成 aktif:// URL.
RegisterKeyframeSequence(keyframeSequence : Instance):ContentId
Memunculkan ID aset sementara dari KeyframeSequence yang dapat digunakan untuk tes lokalisasi animasi. Memunculkan hasil pencarian.
GetAnimations(userId : number):Instance
Hasil
Fungsi ini mengembalikan objek InventoryPages yang dapat digunakan untuk mengulangi atas animasi yang dimiliki pengguna tertentu.
GetKeyframeSequenceAsync(assetId : ContentId):Instance
Hasil
Mengembalikan KeyframeSequencer berdasarkan asetId yang ditentukan secara asinkron.

Acara

Properti

Metode

RegisterActiveKeyframeSequence

ContentId

Memunculkan ID aset sementara dari KeyframeSequence yang dapat digunakan untuk tes lokalisasi animasi.

Fungsi ini melakukan fungsi yang sama untuk KeyframeSequenceProvider:RegisterKeyframeSequence() fungsi ini menghasilkan URL aktif:// alih-alih fungsi hasil.

ID yang dihasilkan dapat digunakan dalam properti Animation.AnimationId untuk tes.

ID aset yang dihasilkan oleh fungsi ini sementara dan tidak dapat digunakan di luar Studio. Pengembang yang ingin menghasilkan ID aset yang dapat digunakan secara online harus mengunggah KeyframeSequence ke Roblox.

Parameter

keyframeSequence: Instance

Class.KeyframeSequencer untuk digunakan.

Memberikan nilai

ContentId

Sebuah ID aset sementara yang dihasilkan untuk memutar animasi lokal.

Contoh Kode

This code sample contains a simple function to generate an Animation with a generated hash ID to preview a KeyframeSequence locally.

Create temporary animation

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)

RegisterKeyframeSequence

ContentId

Memunculkan ID aset sementara dari KeyframeSequence yang dapat digunakan untuk tes lokalisasi animasi.

Fungsi ini melakukan fungsi yang sama untuk KeyframeSequenceProvider:RegisterActiveKeyframeSequence() namun fungsi ini menghasilkan hashr sebagai buah persiksa alih-alih URL aktif://.

ID yang dihasilkan dapat digunakan untuk properti Animation.AnimationId untuk menguji animasi.

Parameter

keyframeSequence: Instance

Class.KeyframeSequencer untuk digunakan.

Memberikan nilai

ContentId

Sebuah ID aset sementara yang dihasilkan untuk memutar animasi lokal.

Contoh Kode

KeyframeSequenceProvider:RegisterKeyframeSequence

local KeyframeSequenceProvider = game:GetService("KeyframeSequenceProvider")

local asset = KeyframeSequenceProvider:RegisterKeyframeSequence(workspace.KeyframeSequence)

local animation = Instance.new("Animation")
animation.Name = "TestAnimation"
animation.AnimationId = asset
animation.Parent = workspace

GetAnimations

Hasil

Fungsi ini mengembalikan objek InventoryPages yang dapat digunakan untuk mengulangi atas animasi yang dimiliki pengguna tertentu.

Fungsi ini memiliki beberapa potensi penggunaan, seperti memungkinkan pengguna untuk menelusuri dan mengimpor animasi ke plugin animasi khusus.

Parameter

userId: number

ID pengguna dari pengguna.

Memberikan nilai

Sebuah InventoryPages animasi.

Contoh Kode

This code sample includes a demonstration of how the content IDs of animations belonging to a player can be downloaded using KeyframeSequenceProvider:GetAnimations(). To run this code be sure to change the USER_ID variable to the ID of the user whose animations you want to download.

KeyframeSequenceProvider GetAnimations

local KeyframeSequenceProvider = game:GetService("KeyframeSequenceProvider")

local USER_ID = 0 -- Insert your UserId here

local function extractPages(pagesObject)
	local array = {}
	while true do
		local thisPage = pagesObject:GetCurrentPage()
		for _, v in pairs(thisPage) do
			table.insert(array, v)
		end
		if pagesObject.IsFinished then
			break
		end
		pagesObject:AdvanceToNextPageAsync()
	end
	return array
end

local inventoryPages = KeyframeSequenceProvider:GetAnimations(USER_ID)

local animationIds = extractPages(inventoryPages)

for _, id in pairs(animationIds) do
	print(id)
end
print("total: ", #animationIds)

GetKeyframeSequenceAsync

Hasil

GetKeyframeSequencer mengembalikan KeyframeSequence berdasarkan assetId yang ditentukan. AssetId harus sesuai dengan animasi. Fungsi ini akan dihasilkan sampai KeyframeSequence dimuat dari situs web. Karena ini adalah panggilan web, fungsinya harus dibungkung dalam panggilan.

Parameter

assetId: ContentId

ID konten animasi.

Memberikan nilai

Class.KeyframeSequencer ditemukan.

Contoh Kode

Demonstrates getting an animation's KeyframeSequence using KeyframeSequenceProvider:GetKeyframeSequenceAsync() and printing the time of each keyframe.

Getting an animation's KeyframeSequence

local KeyframeSequenceProvider = game:GetService("KeyframeSequenceProvider")

local ANIMATION_ID = "rbxassetid://507771019"

-- Get the keyframe sequence for the asset
local keyframeSequence
local success, err = pcall(function()
	keyframeSequence = KeyframeSequenceProvider:GetKeyframeSequenceAsync(ANIMATION_ID)
end)

if success then
	-- Iterate over each keyframe and print its time value
	local keyframeTable = keyframeSequence:GetKeyframes()
	for key, value in keyframeTable do
		print(`The time of keyframe number {key} is: {value.Time}`)
	end
else
	print(`Error getting KeyframeSequence: {err}`)
end

Acara