DynamicSpotLight

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Light
  • DynamicLight（11 属性）
    • [DynamicSpotLight]（2 属性）

继承成员

1 个来源 / 11 属性

• 来自 DynamicLight（11 属性）
  • 属性：Position、Rotation、Enabled、Intensity、Range、Color、FogClamp、EnableShadow、ShadowQuality、Priority、IsStaticOptimization

动态聚光源以锥形区域向场景投射真实光照，并用内锥角与外锥角两个属性分别描述光锥中心的高亮范围与外围的柔和过渡范围，从而控制光束的集中程度与边缘衰减。调整这两个角度即可在狭窄聚光与较宽泛光之间切换，适合塑造带有方向感的局部照明。

适用场景

需要在场景中营造有方向性的锥形照明时使用，例如为角色手持灯具、舞台追光或场景中的重点展示物添加一盏可随时改变光束宽窄的光源。

使用要点

通过 game:CreateUnit("DynamicSpotLight", config) 或 World:CreateUnit("DynamicSpotLight", config) 创建实例，创建时可在配置中给出 InnerAngle 与 OuterAngle 的初始值。创建完成后直接读写这两个属性，即可调整光锥中心的聚焦范围与外沿的柔和范围。

注意事项

该类型只能通过 game:CreateUnit 或 World:CreateUnit 获取实例，不存在直接构造的写法，也不要使用点号构造形式。创建后请先确认实例有效再读写 InnerAngle 与 OuterAngle，避免在实例已被销毁的情况下继续访问属性。

代码示例

创建 DynamicSpotLight 实例

-- @runtime client
local World = game:GetService('World')
local dynamicSpotLight = World:CreateUnit('DynamicSpotLight', {})
if dynamicSpotLight == nil then return end
print('DynamicSpotLight 已创建:', tostring(dynamicSpotLight))

属性 (2)

Name	类型	默认值	说明
InnerAngle	Float	30.0	InnerAngle 是 DynamicSpotLight 的内锥角属性，类型为 Float，用于描述聚光灯内层光锥的张角大小。该属性可读可写，默认值为 30.0。
OuterAngle	Float	45.0	OuterAngle 是 DynamicSpotLight 的外锥角属性，类型为 Float，用于描述聚光灯外层光锥的张角大小。该属性可读可写，默认值为 45.0。

关联类型

• DynamicLight