KeyframeSequence | 文档 - Roblox 创作者中心

引擎类

KeyframeSequence

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按此处。

概要

属性

AuthoredHipHeight:number

方法

AddKeyframe(keyframe: Instance):()

GetKeyframes():{Keyframe}

RemoveKeyframe(keyframe: Instance):()

继承成员

3 个继承自 AnimationClip

57 个继承自 Instance

6 个继承自 Object

代码示例

获取关键帧序列长度

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 keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Loop = false
keyframeSequence.Priority = Enum.AnimationPriority.Action

-- 创建关键帧
local keyframe = Instance.new("Keyframe")
keyframe.Time = 0

-- 创建示例姿势
local rootPose = Instance.new("Pose")
rootPose.Name = "HumanoidRootPart"
rootPose.Weight = 0
local lowerTorsoPose = Instance.new("Pose")
lowerTorsoPose.Name = "LowerTorso"
lowerTorsoPose.Weight = 1

-- 设置序列层次结构
rootPose:AddSubPose(lowerTorsoPose)
keyframe:AddPose(rootPose)
keyframeSequence:AddKeyframe(keyframe)

-- 将序列的父级设为工作区
keyframeSequence.Parent = workspace

API 参考

属性

AuthoredHipHeight

隐藏

插件安全性

读取并联

功能： Animation

KeyframeSequence.AuthoredHipHeight:number

方法

AddKeyframe

功能： Animation

KeyframeSequence:AddKeyframe(keyframe:Instance):()

参数

keyframe:Instance

()

代码示例

关键帧序列实例化

-- 创建序列
local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Loop = false
keyframeSequence.Priority = Enum.AnimationPriority.Action

-- 创建关键帧
local keyframe = Instance.new("Keyframe")
keyframe.Time = 0

-- 创建示例姿势
local rootPose = Instance.new("Pose")
rootPose.Name = "HumanoidRootPart"
rootPose.Weight = 0
local lowerTorsoPose = Instance.new("Pose")
lowerTorsoPose.Name = "LowerTorso"
lowerTorsoPose.Weight = 1

-- 设置序列层次结构
rootPose:AddSubPose(lowerTorsoPose)
keyframe:AddPose(rootPose)
keyframeSequence:AddKeyframe(keyframe)

-- 将序列的父级设为工作区
keyframeSequence.Parent = workspace

GetKeyframes

功能： Animation

KeyframeSequence:GetKeyframes():{Keyframe}

{Keyframe}

代码示例

获取关键帧序列长度

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

功能： Animation

KeyframeSequence:RemoveKeyframe(keyframe:Instance):()

参数

keyframe:Instance

()

代码示例

关键帧序列删除关键帧

local keyframeSequence = Instance.new("KeyframeSequence")
keyframeSequence.Parent = workspace

local keyframe = Instance.new("Keyframe")

keyframeSequence:AddKeyframe(keyframe)

task.wait(2)

keyframeSequence:RemoveKeyframe(keyframe)

KeyframeSequence