Runtime API / Property

NodeScriptContext.mounted

显式读取当前 ECS 物理挂载实体;SceneApi 继续只负责稳定语义树。

使用说明

使用 resolve(ref) 取得当前 canonical mounted entity,使用 children(ref) 读取 direct physical children,使用 probe(ref) 读取 live geometry/visibility。ref 可以是 role、semantic ref 或已有 mounted handle。

返回 snapshot 的 revision 用于判断缓存是否过期。Variant、Slot 或 rematerialization 改变 revision 后重新解析;不要持久化或按字符串格式解析 entity.id。

const tree = ctx.mounted.children('viewport');
if (!tree) return;
for (const child of tree.children) {
ctx.trace('mounted-child', {
semanticRef: child.semanticRef,
revision: child.revision,
});
}

按名称、role 或组件语义查询仍使用 ctx.scene。两棵树的完整区别见语义 Scene Tree 与 Mounted Entity Tree。