HarmonyOS游戏引擎：用ArkTS实现ECS架构解决页面驱动困境

鸿蒙专家

很多开发者在起步做HarmonyOS游戏时，习惯把页面作为游戏的主宰，所有角色、碰撞、AI、动画都挂在页面生命周期里。但随着角色增多、玩法变复杂，或者需要支持手机、平板、PC多端，甚至加入AI NPC和联网同步，问题就会暴露：页面销毁导致游戏状态丢失，页面切换时动画暂停，多端切换状态混乱。本质上，UI生命周期不等于游戏生命周期。对于中小型游戏、AI游戏或互动应用，不需要Unity那样的庞大引擎，完全可以用ArkTS从0到1构建一个轻量级游戏Runtime，核心思路就是ECS架构——以Engine为大脑，用World管理实体，Component定义数据，System执行逻辑。

2. Engine
3. │
4. ├── World（世界）
5. ├── Entity（实体）
6. ├── Component（组件）
7. ├── System（系统）
8. ├── Scene（场景）
9. ├── Resource（资源）
10. ├── Event（事件）
11. ├── Input（输入）
12. └── Update Loop（主循环）

复制代码

先把Engine建起来。它是整个游戏世界的大脑，负责管理所有System和World，并在每帧驱动它们。

2. class GameEngine {
3.   world: World
4.   systems: BaseSystem[] = []
5.   constructor() {
6.     this.world = new World()
7.   }
8.   addSystem(system: BaseSystem) {
9.     this.systems.push(system)
10.   }
11.   update() {
12.     this.systems.forEach(system => {
13.       system.update(this.world)
14.     })
15.   }
16. }
17. const engine = new GameEngine()

复制代码

World保存所有实体（玩家、敌人、子弹、NPC、宝箱等），是游戏宇宙的容器。

2. class World {
3.   entities: Entity[] = []
4.   add(entity: Entity) {
5.     this.entities.push(entity)
6.   }
7. }

复制代码

Entity本身不包含逻辑，只是一个组件容器，通过Map保存任意类型的组件。

2. class Entity {
3.   id: number = 0
4.   components = new Map<string, object>()
5. }
6. entity.components.set("Transform", new TransformComponent())

复制代码

Component是纯粹的数据。比如位置组件、生命值组件、攻击组件：

2. class TransformComponent { x = 0; y = 0 }
3. class HPComponent { hp = 100 }
4. class AttackComponent { damage = 20 }

复制代码

玩家就是Transform + HP + Attack，敌人则是Transform + HP + AI。这种组合方式让复用性极高，也是ECS的核心优势。

真正运行逻辑的是System。例如移动系统遍历所有实体，找到Transform组件并修改坐标：

2. class MoveSystem {
3.   update(world: World) {
4.     world.entities.forEach(entity => {
5.       let transform = entity.components.get("Transform")
6.       if (transform) {
7.         transform.x += 5
8.       }
9.     })
10.   }
11. }

复制代码

战斗系统、AI系统也是类似。每一帧由engine.update()触发，系统按顺序执行：MoveSystem → CollisionSystem → CombatSystem → AISystem。这正是Unity DOTS的核心思想。

场景（Scene）负责管理关卡，切换场景时隔离状态和资源：

2. class Scene {
3.   world = new World()
4.   enter() {}
5.   exit() {}
6. }
7. sceneManager.changeScene(new BattleScene())

复制代码

ResourceManager统一管理图片、音频、动画等资源，避免重复加载和内存泄漏：

2. class ResourceManager {
3.   cache = new Map()
4.   load(path: string) {}
5. }

复制代码

EventBus实现模块间解耦，比如敌人死亡时触发事件，金币系统和任务系统各自监听做不同响应：

2. eventBus.emit("enemyDead")
3. eventBus.on("enemyDead", () => { addGold() })
4. eventBus.on("enemyDead", () => { checkTask() })

复制代码

HarmonyOS支持触摸、鼠标、键盘、遥控器、手柄等多种输入方式，通过InputSystem统一抽象，上层只关心move(input.getAxis())，不关心底层是touch还是键盘，这样就能轻松在手机、平板、PC、TV上统一运行。

最后是最核心的Update Loop，所有游戏引擎的命脉：

2. class Engine {
3.   tick() {
4.     this.update()
5.     requestAnimationFrame(() => {
6.       this.tick()
7.     })
8.   }
9. }

复制代码

这会形成一个无限循环：update() → render()，整个游戏世界开始运转。

在AI时代，可以加入AgentSystem让NPC具备感知、记忆、规划和行动的能力：

2. class AgentSystem {
3.   update(world) {
4.     npcList.forEach(npc => {
5.       npc.think()
6.       npc.plan()
7.       npc.execute()
8.     })
9.   }
10. }

复制代码

最终引擎架构如下：Engine下挂SceneManager和ResourceManager，Scene包含World，World包含Entity，Entity挂载Component，Component被各个Systems（Move、Combat、AI、Physics、Event、Agent、Input、Animation、Network）处理，最后输出到Render。数据流为：Input → World → System → State → UI Render。

很多人觉得游戏引擎很复杂，只有Unity、Unreal才需要。但对于HarmonyOS来说，引擎不是庞大的软件，而是一套Runtime思维。它本质上只解决四个问题：世界怎么组织？对象怎么管理？逻辑怎么运行？系统怎么扩展？当AI、Agent、分布式能力逐渐进入鸿蒙游戏生态后，未来真正重要的可能不再是UI Framework，而是Runtime + ECS + Agent System。未来的HarmonyOS游戏，不一定运行在Unity上，但一定运行在某种Engine上。

热心网友7

楼主分享得很详细，这套ECS架构的思路很清晰。确实，很多初学者容易把页面生命周期和游戏逻辑强绑定，一旦复杂度上来就进退两难。用World统一管理实体状态，用System剥离逻辑，这样做多端适配和状态恢复都会轻松很多。另外，你提到的EventBus解耦模块、AgentSystem扩展AI策略，都是很实用的设计。不知道在实际项目中，组件的回收和复用这块你是怎么做内存优化的？期待后续分享。