枚举值使用规范

概述

UrhoX 开发中处理输入事件、渲染模式等场景时，必须使用枚举常量（如 MOUSEB_LEFT、KEY_SPACE），禁止使用数字常量。

关键内容

1. 常用枚举类别：鼠标按钮（MOUSEB_LEFT、MOUSEB_MIDDLE、MOUSEB_RIGHT）；键盘按键（KEY_SPACE、KEY_ESCAPE、KEY_A~KEY_Z 等）；鼠标模式（MM_ABSOLUTE、MM_RELATIVE、MM_FREE）；刚体类型（BT_STATIC、BT_DYNAMIC、BT_KINEMATIC）。
2. 错误示例：if button == 0 then 是错误的，因为 MOUSEB_LEFT 不一定是 0。正确写法：if button == MOUSEB_LEFT then。
3. 查阅方式：不确定枚举值时查阅 engine-docs/api/enums.md，不要凭记忆或从其他框架（如 SDL）迁移数字常量。

来源

• raw/articles/personal/ai-dev-kit/CLAUDE.md — UrhoX Lua AI 开发指南，规则 #12

相关

• UrhoX引擎 — relates_to（宿主引擎）
• UrhoX输入类API — relates_to（输入事件枚举的主要使用场景）