KeyframeSequenceProvider

Phương Pháp

RegisterActiveKeyframeSequence(keyframeSequence : Instance):ContentId
Tạo một ID tài sản tạm thời từ một KeyframeSequence có thể được sử dụng để thử nghiệm địa phương hóa cho một hoạt hiệu ứng động. Tạo một URL active:// .
RegisterKeyframeSequence(keyframeSequence : Instance):ContentId
Tạo một ID tài sản tạm thời từ một KeyframeSequence có thể được sử dụng để thử nghiệm địa phương hóa cho một hoạt hiệu ứng động. Tạo một hash.
GetAnimations(userId : number):Instance
Sinh Lợi
Chức năng này trả về một đối tượng InventoryPages có thể được sử dụng để lặp lại các hoạt họa thuộc về một người dùng cụ thể.
GetKeyframeSequenceAsync(assetId : ContentId):Instance
Sinh Lợi
Trả về một chuỗi khung chìa khóa dựa trên ID tài sản được chỉ định theo cách không đồng bộ.

Sự Kiện

Thuộc Tính

Phương Pháp

RegisterActiveKeyframeSequence

ContentId

Tạo một ID tài sản tạm thời từ một KeyframeSequence có thể được sử dụng để thử nghiệm địa phương hóa cho một hiệu ứng động.

Chức năng này thực hiện chức năng tương tự với KeyframeSequenceProvider:RegisterKeyframeSequence() tuy nhiên chức năng này tạo ra một URL active:// thay vì một hash.

ID được tạo có thể được sử dụng trong một thuộc tính Animation.AnimationId để kiểm tra.

ID tài sản được tạo bởi chức năng này là tạm thời và không thể sử dụng bên ngoài Studio.Các nhà phát triển muốn tạo một ID tài sản có thể được sử dụng trực tuyến nên tải lên KeyframeSequence vào Roblox.

Tham Số

keyframeSequence: Instance

Các KeyframeSequence được sử dụng.

Giá Trị Mặc Định: ""

Lợi Nhuận

ContentId

Một ID tài sản tạm thời được tạo ra cho phát lại hoạt hình địa phương.

Mẫu mã

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

Tạo một ID tài sản tạm thời từ một KeyframeSequence có thể được sử dụng để thử nghiệm địa phương hóa cho một hiệu ứng động.

Chức năng này thực hiện chức năng tương tự với KeyframeSequenceProvider:RegisterActiveKeyframeSequence() tuy nhiên chức năng này tạo ra một hash thay vì một URL active:// .

ID được tạo có thể được sử dụng cho thuộc tính Animation.AnimationId để kiểm tra hoạt họa.

Tham Số

keyframeSequence: Instance

Các KeyframeSequence được sử dụng.

Giá Trị Mặc Định: ""

Lợi Nhuận

ContentId

Một ID tài sản tạm thời được tạo ra cho phát lại hoạt hình địa phương.

Mẫu mã

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

Sinh Lợi

Chức năng này trả về một đối tượng InventoryPages có thể được sử dụng để lặp lại các hoạt họa thuộc về một người dùng cụ thể.

Chức năng này có một số cách sử dụng tiềm năng, chẳng hạn như cho phép người dùng duyệt và nhập các hoạt họa vào một plugin hoạt họa tùy chỉnh.

Tham Số

userId: number

ID người dùng của người dùng.

Giá Trị Mặc Định: ""

Lợi Nhuận

Một InventoryPages của hoạt hình.

Mẫu mã

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

Sinh Lợi

GetKeyframeSequenceAsync trả về một KeyframeSequence dựa trên ID tài sản được chỉ định.ID tài sản phải phù hợp với một hoạt hiệu ứng động.Chức năng sẽ hoạt động cho đến khi KeyframeSequence được tải từ trang web.Bởi vì đây là một cuộc gọi web nó nên được bọc trong một cuộc gọi pcall.

Tham Số

assetId: ContentId

ID nội dung của hoạt hiệu ứng động.

Giá Trị Mặc Định: ""

Lợi Nhuận

The KeyframeSequence được tìm thấy.

Mẫu mã

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

Sự Kiện