SimpleSpotShadowLight

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

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

继承成员

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

SimpleSpotShadowLight 是暗调锥形自发光体，用于低亮度方向性装饰，不会照亮周围物体。

适用场景

用于暗色舞台光束、方向指示或需要沉暗锥形外观的场景。

使用要点

通过 World:CreateUnit("SimpleSpotShadowLight", config) 创建实例，设置 Color 调整暗调外观，并用 InnerAngleFactor 控制锥形内角因子。

注意事项

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

代码示例

创建暗调锥形光源

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

local light = world:CreateUnit("SimpleSpotShadowLight", {
    Position = Vector3.New(0, 3, -10),
    Color = Color.New(102, 102, 255, 255),
    InnerAngleFactor = 0.5,
})
print("SimpleSpotShadowLight:", light)

属性 (3)

Name	类型	默认值	说明
Color	Color	Color.New(255, 255, 255, 255)	暗调锥形自发光体的颜色。
InnerAngleFactor	Float	0.5	控制暗调锥形自发光外观内角大小的因子。
Transparency	Float	0.6	控制 SimpleSpotShadowLight 阴影的透明度。值越小阴影越不透明，值越大阴影越透明。

关联类型

• SimpleLight
• Color