增加loading界面
This commit is contained in:
1 parent
a3f61a29d0
commit
e84e14783e
69 files changed
+1394
-31
No files matched your search
+3
-3
@@ -1,6 +1,6 @@
|
||||
# Fruit Pop 游客登录
|
||||
|
||||
本阶段仅实现登录场景、两步游客认证及本地会话保存,不包含加载页或游戏主界面。
|
||||
当前实现登录场景、两步游客认证、本地会话保存及认证期间的 loading 界面层,尚不包含游戏主界面。
|
||||
|
||||
## 场景与美术
|
||||
|
||||
@@ -40,8 +40,8 @@
|
||||
本地存储前缀为 fruit-pop.auth,按服务地址与产品隔离。重登失败不覆盖旧成功会话。
|
||||
首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。
|
||||
|
||||
认证成功后显示 Signed in successfully. 并发出不含 token 的 guest-authenticated 事件,供后续加载功能衔接。
|
||||
当前不添加加载场景,也不自动跳转。
|
||||
点击游客按钮后由独立 StartupLoadingView 展示同场景 loading 层。认证成功时发出不含 token 的 guest-authenticated 事件;进度收满并短暂停留后恢复 Signed in successfully. 落点,发出 startup-preparation-ready 事件。
|
||||
当前没有游戏主场景,不自动跳转;后续游戏场景加载与首屏就绪必须显式接入完成条件,不能把认证成功等同于游戏就绪。详见 startup-loading.md。
|
||||
|
||||
## 验证记录
|
||||
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
# Fruit Pop 加载界面
|
||||
|
||||
## 范围
|
||||
|
||||
- 在 Welcome 场景 Canvas 下添加独立 PreparationPanel,复用已有背景、Logo、水果节点。
|
||||
- 按 1080×1920 loading 参考图安排标题、百分比、进度槽及 Getting things ready;所有节点在编辑器中独立可修改,运行时不创建 UI。
|
||||
- 新切图通过资源工具导入到 assets/startup/visuals,命名 prep-meter-frame.png、prep-meter-fill.png。原始美术未修改,参考整图未作为运行背景导入。
|
||||
- 进度填充采用左锚点与九宫格,左右边距各 48 像素,满格宽度按槽内边界限制为 906,保留圆头和高光;原图上的 70% 只是编辑器展示样例。
|
||||
|
||||
## 职责与流程
|
||||
|
||||
- GuestLoginView 继续管理按钮绑定和认证生命周期,通过 guest-login-state-changed 发布无会话内容的展示状态。
|
||||
- StartupProgress 是独立于引擎的进度状态机。等待期间只估算到 90%,不会自行完成;认证成功后用 0.24 秒平滑收满,并显示 100% 至少约 0.12 秒。
|
||||
- StartupLoadingView 绑定已保存的场景节点,隐藏按钮和页脚,不禁用拥有认证请求的 WelcomeComposition。失败恢复原控件并展示最新错误,可再次点击登录。
|
||||
- 成功提示在 loading 收尾期间保持隐藏,结束后恢复。组件临时禁用保留待收尾状态,再启用后继续,不重复发送完成通知。
|
||||
- 当前没有主场景,完成后返回现有认证成功落点,并发送不含 token 的 startup-preparation-ready。后续接游戏场景时,需要让完成条件等待场景加载及首屏实际就绪;当前没有假装预加载不存在的资源。
|
||||
- 只参考 crimson-lantern 的职责分离、加载上限和真实完成原则,未复制其实现,也未引入原生更新工作流。
|
||||
|
||||
## 验证
|
||||
|
||||
- pnpm@11.17.0 安装锁定依赖,pnpm typecheck、pnpm test(19 项)通过。验收过程中出现过编辑器调整按钮缩放导致旧布局契约失败,后续保存值已恢复为 1;未放宽原登录布局测试。
|
||||
- 测试覆盖进度单调与上限、无效时间、真实完成和重置、场景布局、资源命名及九宫格边距、认证组件绑定。
|
||||
- PinK 场景预览核对 loading 展示、失败恢复、收尾文字互斥、禁用再启用及完成事件单次发送。
|
||||
- 编辑器允许打开 PreparationPanel 预览美术;初始隐藏由 StartupLoadingView.onLoad 执行,并在发布页验证,不强制覆盖编辑器可见状态。
|
||||
- web-mobile 构建成功。发布页注入验签失败后恢复可重试;随后真实两步认证成功,100% 后撤层并发送一次完成事件。
|
||||
- 540×960、390×844、390×640、844×390 核对主体与 loading 控件边界均在可见区域内,切图尺寸比例保持一致。
|
||||
- 最终产物 build/web-mobile-startup-release,构建成功;最终 pnpm typecheck 和 19 项测试全部通过。发布页启动隐藏覆盖层、满格宽度 906、左右圆头及恢复后的控件状态已复核。
|
||||
|
||||
未进行原生构建和真机验证;当前没有原生子工程,本轮范围为场景 UI 与 Web 认证流程。
|
||||
Reference in new issue
Block a user