PresetLink

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • [PresetLink]

继承成员

1 个来源 / 4 属性 / 25 函数 / 6 事件

• 来自 Unit（4 属性 / 25 函数 / 6 事件）
  • 属性：AssetId、Name、Desc、Parent
  • 函数：ClearAllChildren、GetChildren、GetDescendants、IsAncestorOf、IsDescendantOf、FindFirstAncestor、FindFirstAncestorWhichIsA、FindFirstAncestorOfClass、FindFirstChild、FindFirstChildWhichIsA、FindFirstChildOfClass、HasChildren、GetChildCount、GetChildAtIndex、SetAttribute、GetAttribute、GetAllProps、Clone、IsA、Destroy、GetPropertyChangedSignal、GetAttributeChangedSignal、FindFromPath、GetFullPath、GetDebugId
  • 事件：ChildAdded、ChildRemoved、DescendantAdded、DescendantRemoving、AncestryChanged、Destroying

PresetLink 是预设资源链接在场景树中的标记 Unit，用于表示某个场景对象与预设资源之间的关联。

适用场景

当脚本需要识别或调试由预设系统生成的对象时，可以在目标单位的子节点中查找 PresetLink，并使用 Unit 继承成员读取路径与父子关系。

使用要点

PresetLink 通常由编辑器或预设系统维护，游戏脚本不直接 CreateUnit 创建；运行时只在已存在对象下查找并使用 Unit 继承方法读取路径、父子关系等基础信息。

注意事项

PresetLink 当前没有公开 Status 属性或返回 PresetLinkStatus 的方法；不要从该标记 Unit 推断预设同步状态。

代码示例

查找单位下的 PresetLink

-- @runtime client
local World = game:GetService('World')
local target = World:FindFirstChild('PresetUnit')

if target ~= nil then
    local presetLink = target:FindFirstChildWhichIsA('PresetLink')
    if presetLink ~= nil then
        print('预设链接路径:', presetLink:GetFullPath())
    end
end

关联类型

• Unit