SimpleAreaLight

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • SimpleLight（6 属性）
    • [SimpleAreaLight]（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

SimpleAreaLight 是矩形平面形态的装饰性自发光体；它自身呈现亮色，但不会作为真实光源照亮周围物体。

适用场景

用于电视屏幕、LED 广告牌、窗面亮片等需要矩形自发光外观的装饰。

使用要点

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

注意事项

SimpleAreaLight 创建后需要绑定到引擎支持的光照挂载结构并处于可渲染场景中才可能生效；单独 World:CreateUnit 或简单挂到 LightingService/WorldUnit 不一定产生视觉表现。当前表现依赖渲染管线版本，请在目标端实测。

代码示例

创建面光源并设置基础属性

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

local light = world:CreateUnit("SimpleAreaLight", {
    Position = Vector3.New(0, 3, 5),
    Brightness = 2.0,
    Color = Color.New(255, 240, 200, 255),
    Size = Vector2.New(4, 2),
})
-- 是否可见取决于当前渲染管线和光源挂载结构，请在目标端实测
print("SimpleAreaLight:", light)

属性 (4)

Name	类型	默认值	说明
Brightness	Float	1.0	面光源的亮度，数值越大光源越亮。
Color	Color	Color.New(255, 255, 255, 255)	面光源的颜色，使用 Color 类型表示 RGBA 值。
Size	Vector2	[1.0, 1.0]	面光源的尺寸，使用 Vector2 类型表示宽度和高度。
LightPattern	String	official://skin/50606_0 (Default)	设置面光源的照射图案纹理，用于改变光源投射出的光斑形状或样式。

关联类型

• SimpleLight
• Color
• Vector2