SimplePointLight

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

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

继承成员

2 个来源 / 10 属性 / 25 函数 / 6 事件

• 来自 SimpleLight（6 属性）
  • 属性：Position、Rotation、Scale、Enabled、OpenEvent、CloseEvent
• 来自 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

SimplePointLight 是球状点形态的装饰性自发光体；它自身呈现亮色，但不会照亮周围物体。

适用场景

用于灯泡外观、火把亮点、魔法球或其他点状自发光装饰。

使用要点

通过 World:CreateUnit("SimplePointLight", config) 创建实例，用 Color、Brightness、Radius 和 AttenuationEnable 调整自发光外观。

注意事项

当前运行包实测 SimplePointLight 即使创建后挂到 WorldUnit 也没有视觉表现，且公开 API 未说明可用的光照挂载结构。以下代码只展示属性形态，不能作为可见效果验收；在引擎补齐挂载契约或可用预设前，不建议用于正式内容。

代码示例

创建点光源并设置范围

-- @runtime server
local world = game:GetService("World")

local light = world:CreateUnit("SimplePointLight", {
    Position = Vector3.New(0, 2, 0),
    Scale = Vector3.New(15, 15, 15),
    Color = Color.New(255, 220, 120, 255),
    Radius = 30,
    Brightness = 5,
    AttenuationEnable = true,
})
print("SimplePointLight radius:", light.Radius)

属性 (4)

Name	类型	默认值	说明
Color	Color	Color.New(255, 255, 255, 255)	点光源的颜色，使用 Color 类型表示 RGB 值。
Brightness	Float	1.0	点状自发光体自身的亮度。
Radius	Float	5.0	控制点状自发光外观半径的参数，不表示真实照明影响范围。
AttenuationEnable	Bool	true	是否启用点状自发光外观的距离衰减。

关联类型

• SimpleLight
• Color