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]	矩形自发光面的宽和高，用于调整面板外观尺寸。
LightPattern	String	official://skin/50606_0 (Default)	矩形自发光面的图案资源标识，用于切换 Default、Grille、StainedGlass、Mottled 或 WaterRipple 外观。

关联类型

• SimpleLight
• Color
• Vector2