SuperAPI AI 工具集

lighting-environment

通用与其它

查看项目

更新于 10-16 05:05

技能介绍

用途:在 Decentraland 场景中配置动态光照与环境,包括光源、阴影、昼夜时间与领域信息读取。

主要能力:LightSource 支持点光源与聚光灯,聚光灯方向跟随实体的 Transform 旋转,含 innerAngle 与 outerAngle 锥角参数;可开启阴影,且阴影仅支持聚光灯;支持 shadowMaskTexture 投影图案;可在运行时通过 LightSource.getMutable 切换 active;SkyboxTime 支持 fixedTime 固定时间与 transitionMode 过渡,并能用系统实现昼夜循环;getWorldTime 读取世界时间,getRealm 读取当前领域、网络与 baseUrl;Material 支持自发光(emissiveColor、emissiveIntensity)产生辉光。

使用方式:光源可在 main-entities.ts 中与 GltfContainer 同实体声明,纯装饰光可只保留 Transform;也可在 src/index.ts 中创建。固定时间可写入 scene.json 的 skyboxConfig.fixedTime。常用导入如 import { engine, SkyboxTime } from '@dcl/sdk/ecs' 与 import { getWorldTime } from '~system/Runtime'。

适用场景:夜景氛围、舞台灯光、灯具、发光球体与昼夜循环。

限制:每块地块(16m x 16m)最多一个活动光源;渲染器按质量与距离剔除,可同时看到 4–10 个光源;带阴影光源最多约 3 个;强度单位为 candela,点光约 8000–32000、聚光约 10000–24000 才可见,低于约 1000 通常不可见;自发光材质不会照亮周围实体。阴影类型 ST_NONE、ST_HARD、ST_SOFT 对应成本递增。价格与平台信息暂未提供。