《游戏编辑器技术原理与架构》7.2 CSV 表导入与行引用
CSV 是「表格进引擎」的事实标准:首行表头、每行一条记录,坑在转义(引号内逗号不是分隔符、双引号用 "" 转义)。本节实现 parseCsv 状态机与 buildIndex 主键索引;6 条用例本机真跑,钉住「表头与行、引号内逗号、双引号转义、空行与 CRLF、主键索引」五条导入不变量。
category
CSV 是「表格进引擎」的事实标准:首行表头、每行一条记录,坑在转义(引号内逗号不是分隔符、双引号用 "" 转义)。本节实现 parseCsv 状态机与 buildIndex 主键索引;6 条用例本机真跑,钉住「表头与行、引号内逗号、双引号转义、空行与 CRLF、主键索引」五条导入不变量。
文档模型深化第一步:helio 卷三的最小文档只有 uid + 三档脏标记,本节补完整操作 API。SceneDocument 收敛 add/remove(级联)/move(拒绝移入自身子树,防环)/set(只允许声明字段),每个操作返回明确成败原因并写进 events 供撤销审计;6 条用例本机真跑,对标 Unity Undo 前的操作留痕。
进入 Play 前冻结编辑状态,退出后原样恢复。本节实现 PlaySession:进入/退出/暂停/单步/快照。6 条用例钉住状态转移与快照回放。对标 Unity Play 模式与 Unreal PIE。
编辑器里大量「数据」不碰渲染管线:数值表、关卡配置、NPC 对话。本节实现 JSON 数据资产三层校验(语法/结构/schema)与 $ref 引用收集;6 条用例本机真跑,钉住「解析成功、非法文本、顶层拒绝、schema 类型与必填、递归 $ref」五条导入不变量。
AudioCue 把一个「声音事件」打包:若干音频资产变体 + 权重 + 播放参数(音量/音调基值与其随机方差)。本节实现 pick(按权重选变体)与 playParams(产出带方差的最终参数);6 条用例本机真跑,钉住「单变体恒选、权重边界、全零权重返回 null、方差扰动在钳制范围」四条引用语义。
编辑器运行时是 TypeScript,游戏脚本可能是 C#、Lua 或未来的 WASM 模块——两套类型系统怎么对上?本节实现 TypeBridge:维护「脚本类型 ↔ 编辑器类型」的双向映射,convert 把脚本值经映射转成编辑器对象;6 条用例本机真跑,为脚本属性暴露与多语言绑定定下转换规则。
层级面板的每个节点有眼睛(可见性)与锁(锁定),且父子影响生效。本节实现有效可见/有效锁定、切换与可选择判定。6 条用例钉住父子传播与锁定覆盖。对标 Unity Hierarchy 的 eye/lock 与 Blender Outliner 的可见/锁定。
音频导入预设:目标格式、重采样率、循环点、归一化、压缩质量。本节实现 audioSettingsFrom——合并 + 校验 + 非法回落默认,与 4.2 纹理设置同型;6 条用例本机真跑,钉住「默认值、部分覆盖、非法回落、循环点自洽」四条设置合并不变量。
类型描述符只说有什么字段,编辑器还想知道怎么显示:亮度该有范围、开关该叫「启用」、某些字段该隐藏。本节实现 HintCatalog:字段级编辑器标记的收集与合并,resolve 只对真实存在的字段生效、悬空 hint 标 invalid;5 条用例本机真跑,对标 Unity 的 Header/Tooltip/Range/HideInInspector。
拖拽节点改变层级:拖到父节点变子、拖到两节点之间调顺序、防环回拖。本节实现祖先判定、重设父子、顺序调整与兄弟顺序。6 条用例钉住环检测、重设与顺序。对标 Unity Hierarchy 拖放与 Unreal Outliner 拖放。
属性面板怎么知道一个对象有哪些字段?靠反射。本节实现 TypeRegistry:用「类型描述符」描述字段的名字、类型、默认值与可编辑性,create 按默认值造实例、validate 校验类型匹配与未知字段;6 条用例本机真跑,这是属性面板、序列化与撤销的共同地基。
WAV 是 RIFF 容器:RIFF 头 + WAVE 标记,之后一串 chunk。本节实现 parseWav——遍历 chunk 找出 fmt(声道/采样率/位深)与 data(PCM 采样),产出可计算的音频描述;6 条用例本机真跑,钉住「声道与时长折算、chunk 偏移定位、非 RIFF/WAVE 返回 null」三条解析不变量。
层级面板把场景对象显示为树:父子关系、类型排序、名称过滤。本节实现树构建、按类型排序、名称过滤。6 条用例钉住树结构与过滤结果。对标 Unity Hierarchy 与 Unreal Outliner。
Ctrl 在 macOS 上是 Cmd,同样的操作不能每平台写一套。本节实现 normalizeInput:把原始按键归一成逻辑快捷键(Mod+K),RebindManager 维护「逻辑快捷键 → 命令 id」绑定表,支持用户重绑定(rebind 强制指派、bindIfFree 冲突守卫)与恢复默认;6 条用例本机真跑。
不同数据类型用不同控件,扩展靠注册表。本节实现 WidgetRegistry:类型到控件的映射、注册优先级与默认兜底。6 条用例钉住注册覆盖、优先级与默认回退。对标 Unity 的 PropertyDrawer 与 Unreal 的 CustomizeDetails。
动画剪辑 = 轨道 × 关键帧,播放 = 按时间插值采样。本节实现 AnimationClip 与 sampleClip——区间内线性插值、越界钳制到首末关键帧、空轨道不产出值;6 条用例本机真跑,钉住「关键帧精确值、中点插值、越界钳制」三条采样语义,为骨骼动画(5.2)接入运行期铺路。
骨骼动画:关节连成树,关节动皮肤跟着动。本节实现 Skeleton(关节树、局部→全局变换)与 skinPosition(蒙皮:顶点按权重混合各关节的逆绑定 + 世界位移);6 条用例本机真跑,钉住「局部累计成全局、单关节权重 1 跟关节走、双关节各半混合」三条蒙皮不变量。
键盘该给谁?拖拽从哪来、落到哪?跨窗口消息该不该发?本节实现三件编辑器的日常:FocusManager 维护全局单焦点并留痕、DragDropManager 管理一次拖放会话(start → dropOn / cancel)、CrossWindowRouter 给跨窗口事件标上来源窗口并静默未注册者;7 条用例本机真跑。
多选时 Inspector 显示共同属性,可一键批量改。本节实现共同值提取、混合标记、批量应用与共同字段判断。6 条用例钉住同值/异值判定与批量覆盖。对标 Unity 多选 Inspector 与 Unreal 多选属性面板。
几百个面板、几十种事件,编辑器全靠一条事件总线活着。本节实现 EventBus:on/once 订阅、返回可退订句柄、退订幂等、单个订阅者抛错被记录而不中断其它订阅者;7 条用例本机真跑,钉住订阅生命周期与异常隔离。