ezEngine场景自动转换中图层数据丢失问题分析

问题背景

在ezEngine游戏引擎中，当使用ezEditorProcessor.exe工具对包含图层(Layer)的场景进行自动转换处理时，发现非主图层的数据在导出文件中丢失。具体表现为：在"Testing Chambers"示例项目中，Ai.ezBinScene场景文件经过转换后大小从应有的45KB缩减到7KB左右，丢失了大量图层数据。

问题现象重现

1. 删除原始场景文件：Data\Samples\Testing Chambers\AssetCache\Common\Scenes\Ai.ezBinScene
2. 运行转换命令：ezEditorProcessor.exe -project "C:\ezBla\Data\Samples\Testing Chambers" -transform Default
3. 生成的Ai.ezBinScene文件大小异常缩小

技术分析

问题根源

经过深入分析，发现问题出在场景文档的加载和导出时序上：

1. 文档加载状态：当ezAssetCurator处理资产时，场景文档尚未打开，系统会调用OpenDocument()打开文档，此时文档状态为"Initializing"而非"Loaded"。

2. 远程导出机制：在调用TransformAsset()进行远程导出时，引擎状态仍处于初始化阶段，尚未完全加载所有图层数据。

3. 数据同步问题：虽然ezAssetDocument::RemoteExport()会检查引擎状态是否为Initializing并断言数据加载，但实际上场景数据的完整传输存在时序问题。

关键发现

1. 手动同步解决：如果在ezSceneDocument::RequestExportScene中手动调用SendGameWorldToEngine()，可以确保所有图层数据正确导出，但这会增加导出时间。

2. 消息处理顺序：当前的消息处理机制中，ezProcessCommunicationChannel::MessageFunc会先执行m_WaitForMessageCallback，然后才广播消息。这种顺序可能导致导出请求在对象创建消息之前被处理。

3. IPC通道时序：引擎状态更新和数据传输之间存在微妙的时序关系，导出请求可能被插入到对象创建消息之前，导致数据不完整。

解决方案

开发者通过以下方式解决了该问题：

1. 确保数据同步：在导出前强制同步所有图层数据到引擎进程。

2. 优化消息处理：调整消息处理顺序，确保所有必要的场景数据在导出请求前已完全传输。

3. 状态检查增强：加强对引擎状态的检查，确保导出操作在正确的状态下执行。

技术启示

这个问题揭示了游戏引擎中资产处理管道的几个重要方面：

1. 异步操作的复杂性：在编辑器与引擎进程间的异步通信中，时序控制至关重要。

2. 状态管理：需要精确管理文档和引擎的各种状态，特别是在自动化处理流程中。

3. 性能与完整性权衡：在确保数据完整性的同时，需要考虑处理效率，避免不必要的同步操作。

该问题的解决不仅修复了图层数据丢失的bug，也为ezEngine的资产处理管道提供了更健壮的实现基础。