O3DE引擎中Qt控件修改组件参数未保存的问题分析

问题概述

在O3DE引擎25.05版本中，开发者发现通过Qt控件(如滑块、颜色选择器等)修改组件参数时，这些修改无法正确保存到预制件(prefab)和场景中。这是一个严重影响工作流的核心功能缺陷，会导致用户修改的参数在场景重新加载后丢失。

问题重现步骤

1. 创建一个实体并添加"Light"组件，选择"Point"类型光源
2. 使用颜色选择器修改光源颜色，使用滑块调整光源强度
3. 保存场景
4. 重新加载场景后，所有通过Qt控件修改的参数都会恢复原状

技术原因分析

这个问题涉及O3DE引擎中几个关键系统的交互：

1. 属性编辑器系统：负责将组件属性暴露给Qt控件
2. 撤销/重做系统：UndoBatch机制未能捕获Qt控件的修改操作
3. 预制件系统：修改后的属性值未能正确标记为"脏数据"，导致保存时被忽略

根本原因在于属性编辑器与Qt控件的值变更信号处理存在缺陷，未能正确触发引擎内部的属性变更通知机制。

影响范围

该缺陷影响所有通过Qt控件修改的组件属性，特别是：

• 光源组件的颜色和强度参数
• 材质组件的各种属性
• 任何使用滑块、颜色选择器等Qt控件暴露的参数

解决方案

开发团队通过以下方式修复了该问题：

1. 确保Qt控件的值变更信号能正确触发属性变更通知
2. 修复UndoBatch系统对这些变更的捕获机制
3. 确保修改后的属性能正确标记为需要保存的状态

修复已合并到稳定分支和开发分支，将在25.05.0版本中发布。

开发者建议

对于遇到类似问题的开发者，建议：

1. 检查属性编辑器与底层属性的绑定机制
2. 验证属性变更通知是否正确传播
3. 确保所有UI交互都能被撤销系统捕获
4. 对于自定义组件，实现正确的属性变更通知接口

这个问题提醒我们在开发编辑器工具时，需要特别注意UI交互与底层数据同步的完整性，特别是在复杂的撤销/重做和预制件系统中。