70 lines
1.6 KiB
C
70 lines
1.6 KiB
C
|
#pragma once
|
|||
|
|
|
|||
|
|
#include <types/base/types.h>
|
|||
|
|
|
|||
|
|
namespace extra2d {
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 模块类型枚举
|
|||
|
|
*/
|
|||
|
|
enum class ModuleType : uint8 {
|
|||
|
|
Core, // 核心模块（必须）
|
|||
|
|
System, // 系统模块（平台相关）
|
|||
|
|
Feature, // 功能模块
|
|||
|
|
Extension // 扩展模块
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 模块接口 - 基于事件总线
|
|||
|
|
*
|
|||
|
|
* 模块不再通过虚函数被调用，而是通过监听事件响应
|
|||
|
|
* 模块可以发送事件，但不应直接调用其他模块
|
|||
|
|
*
|
|||
|
|
* 设计理念：
|
|||
|
|
* - 模块是引擎的内置组件，在编译时确定
|
|||
|
|
* - 模块之间通过事件总线通信，零直接依赖
|
|||
|
|
* - 模块的生命周期由 ModuleRegistry 管理
|
|||
|
|
*/
|
|||
|
|
class IModule {
|
|||
|
|
public:
|
|||
|
|
virtual ~IModule() = default;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取模块名称
|
|||
|
|
* @return 模块唯一标识名
|
|||
|
|
*/
|
|||
|
|
virtual const char* name() const = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取模块类型
|
|||
|
|
* @return 模块类型，用于分类和优先级管理
|
|||
|
|
*/
|
|||
|
|
virtual ModuleType type() const { return ModuleType::Feature; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取模块优先级
|
|||
|
|
* @return 优先级数值，越小优先级越高
|
|||
|
|
*/
|
|||
|
|
virtual int priority() const { return 0; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 初始化模块
|
|||
|
|
*
|
|||
|
|
* 在此注册事件监听器
|
|||
|
|
* 返回 false 表示初始化失败，引擎将停止
|
|||
|
|
*
|
|||
|
|
* @return 初始化是否成功
|
|||
|
|
*/
|
|||
|
|
virtual bool init() { return true; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 关闭模块
|
|||
|
|
*
|
|||
|
|
* 在此执行清理工作
|
|||
|
|
* 事件监听器会自动注销（RAII）
|
|||
|
|
*/
|
|||
|
|
virtual void shutdown() {}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
} // namespace extra2d
|