Skip to content

动作模块基类

系统概览

动作模块基类(ADR-116/126)。提供所有 motion-module 的骨架代码,包括模块创建、 状态管理、帧钩子注册、烘焙准备等。子模块(body-posture/hand-modules/foot-modules/riding-model) 通过覆写基类方法实现自定义行为。

核心职责

  • module-base.ts — 模块骨架代码、状态管理、帧钩子、烘焙。

对外 API(节选)

  • interface ModuleBaseMethods — 模块基础方法接口。
  • interface ModuleBaseOverrides — 可覆写的方法。
  • createModuleBase(config) — 创建模块基类实例。
  • applyModuleSnapshot(snapshot, module) — 应用状态快照。
  • createFrameHookManager() — 创建帧钩子管理器。
  • createModuleShell(config) — 创建模块外壳(运动覆盖模块)。
  • prepareBake(modelId, moduleId) — 准备烘焙。

与其他子系统关系

  • 被 body-posture/hand-modules/foot-modules/riding-model 全部引用。
  • 骨骼覆盖:../bone-override.ts
  • 注册表:./registry.ts

不变量

  • 所有子模块必须通过 createModuleBasecreateModuleShell 创建。
  • 帧钩子必须在模块 dispose() 时清除。