用途:在 Unity 中创建、查询和调校灯光,布置场景照明,并处理光照探针组、反射探针与光照贴图烘焙设置。
主要能力:light_create 新建灯光(Directional/Point/Spot/Area,可设位置、颜色、强度、范围、聚光角度、阴影);light_set_properties 设置单个灯光属性,省略的参数保持原值,返回 applied/skipped 说明哪些参数生效或该灯型不支持;light_set_properties_batch 批量配置多个灯光,items 为 JSON 数组,整体全有或全无,任一项 shadows 非法会回滚已应用项;light_set_enabled 与 light_set_enabled_batch 开关灯光,批量时每项必须显式给出 enabled,否则整体回滚;light_get_info(light_get_properties 为其别名)查询单个灯光的类型、颜色、强度、范围、聚光角度、阴影、开关、剔除遮罩与反弹强度;light_find_all 按类型筛选列出场景灯光;light_add_probe_group 添加光照探针组并可选网格布局;light_add_reflection_probe 创建反射探针;light_get_lightmap_settings 读取烘焙 GI、实时 GI、贴图尺寸与数量等设置。
使用方式:操作 2 个及以上灯光时优先使用 *_batch 技能。单对象技能接受 name、instanceId(优先)或 path,至少提供一个。默认审批模式下变更类技能需用户授权,授权后服务端执行一次并返回结果;查询类技能在三种模式下均无需授权。批量调用示例:unity_skills.call_skill("light_set_properties_batch", items=[{"name": "Light1", "intensity": 2.0}])。
适用场景:主光布置、局部灯光批量调优、灯光批量开关、探针与光照贴图设置检查等。
限制与注意:不存在 light_add、light_set_color、light_set_intensity、light_delete、light_set_shadow 等技能;删除灯光需调用 gameobject module 的 gameobject_delete。shadows 取值为 None/Hard/Soft,输入不区分大小写但返回固定大写形式。本模块不含 Delete、PlayMode、Reload 或高风险技能。调用前应通过 GET /skills/recommend?includeSchema=true 或 unity_skills.get_skill_schema() 确认准确签名与默认值,不要凭名称猜测参数。Area 灯仅支持烘焙,实时阴影应控制数量以兼顾性能。