用途:编写 Creator Hub 场景中挂在单个实体上的 Script 组件所用的 .ts 脚本(自包含类)。
主要能力:脚本文件必须放在 assets/ 内(如 assets/scripts/MyScript.ts),不能放在根级 scripts/;Script 组件的 path 相对项目根解析,需与实际位置一致。每个脚本是单个导出类,构造器前两个参数必须为 public src: string 与 public entity: Entity,可带默认值或 ? 可选参数,并可加 @param 注释生成工具提示;可选 start() 与 update(dt)。构造参数支持 string、number、boolean、Entity、ActionCallback、Slider<Min,Max,Step>,其中 Slider 是 type Slider<...> = number 的别名,非法声明退化为普通数字框。
使用方式:priority 默认 0 表示每帧最后运行,同优先级脚本共享一个系统回调;调高 priority 可提前执行并获得独立系统。用 this.src 拼接仅由代码加载的资产路径。子实体需运行时遍历层级、用 Name 的子串匹配查找。方法前加 /** ... */ 与 @action 才可在 Actions 组件中调用,禁止用装饰器写法。可用 ~sdk/script-utils 的 callScriptMethod、getScriptInstance、getAllScriptInstances、getScriptInstancesByPath 调用其他脚本;ActionCallback 未接线时为 undefined。
限制:layout 中 params 按位置传入构造器,顺序必须与构造参数一致,不能跳过前面的参数;智能物品已迁移为 Script 加 @action,部分非迁移项仍保留 Config 面板。