跳到主要内容

迁移指南（Migration Guide）

本指南用于把旧版 Unreal 插件（直接 State Machine 输入 + 旧事件）迁移到当前 ViewModel-first 架构。

Legacy 指 < 0.4.0 插件版本。

旧输入与旧事件 API 已弃用，新的集成请统一使用 ViewModel。

主要变化​

引擎版本​

  • 最低支持升级为 Unreal Engine 5.7.3+

平台支持​

  • 已支持：Windows / macOS
  • 未支持：Android / iOS

架构变化​

旧模型：

  • Unreal 直接写 State Machine Inputs
  • Unreal 直接监听 State Machine Events

新模型：

  • Unreal 写 ViewModel Instance
  • State Machine 读写 ViewModel 属性
  • Unreal 订阅 ViewModel 属性变更

数据流：

Unreal -> ViewModel Instance -> State Machine -> ViewModel Instance -> Unreal

快速迁移清单​

  1. 升级 Unreal 到 5.7.3+
  2. 升级插件（Fab 或 GitHub）
  3. 用 ViewModel 属性写入替代 legacy inputs
  4. 用 ViewModel 观察替代 legacy events（一次性信号用 Trigger）

输入迁移​

将 Bool/Number/Trigger 输入改为：

  1. 创建 ViewModel Instance
  2. 绑定到 Artboard
  3. 对应写入属性

建议把 ViewModel 作为公开 API，State Machine 作为内部实现。

事件迁移​

将旧事件回调改为：

  • Trigger 属性（一次性动作）
  • 普通属性变化监听（状态同步）

示例映射：

  • “按钮点击” -> Trigger OnClick
  • “过渡完成” -> Trigger OnTransition
  • “选择变化” -> Enum Selection

Blueprint / C++​

统一原则：

  • 不再直接操作 legacy 输入/事件
  • 一律通过 ViewModel 写入 + 观察
  • 动作用 Trigger，状态用 bool/number/enum/string/color