目的
为 Unity 客户端提供属性变化事件和 UI 读取入口,让角色面板、HUD、提示等模块可以订阅玩家属性变化。
原因
属性同步接入后,如果各 UI 直接访问网络消息或缓存内部结构,会形成重复绑定和生命周期问题。需要一个轻量服务入口统一派发变化并提供读取 API。
对应服务端任务
- Server #67:属性组件 Agent 与变化事件
- Server #69:玩家属性同步协议
本次范围
- 增加客户端属性服务或管理器,封装属性缓存读取。
- 属性值变化时派发客户端事件。
- 值未变化时不重复派发事件。
- 提供 UI 层可用的读取接口,例如按属性类型获取最终值。
不在本次范围
- 不实现具体角色属性面板。
- 不做复杂表达式格式化。
- 不做本地战斗属性修改。
验收标准
- UI 或业务模块可以通过统一入口读取玩家属性。
- 快照覆盖和增量更新都能触发必要的变化事件。
- 相同值更新不会重复通知。
- 退出登录或切换账号后事件订阅不会引用旧玩家数据。
- 有最小测试、Editor 校验或手动验证步骤覆盖事件触发和去重。
目的
为 Unity 客户端提供属性变化事件和 UI 读取入口,让角色面板、HUD、提示等模块可以订阅玩家属性变化。
原因
属性同步接入后,如果各 UI 直接访问网络消息或缓存内部结构,会形成重复绑定和生命周期问题。需要一个轻量服务入口统一派发变化并提供读取 API。
对应服务端任务
本次范围
不在本次范围
验收标准