增加游戏玩法界面和各个弹窗初版

This commit is contained in:
zpx committed 2026-11-20 18:51:48 +08:00
1 parent e84e14783e
commit eb48d8e845
211 files changed
+59920 -21

No files matched your search

+3 -3
View File
@@ -1,6 +1,6 @@
# Fruit Pop 游客登录
当前实现登录场景、两步游客认证、本地会话保存及认证期间的 loading 界面层,尚不包含游戏主界面。
当前实现登录场景、两步游客认证、本地会话保存、loading 和 Orchard 主游戏。主游戏说明见 orchard-gameplay.md。
## 场景与美术
@@ -40,8 +40,8 @@
本地存储前缀为 fruit-pop.auth,按服务地址与产品隔离。重登失败不覆盖旧成功会话。
首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。
点击游客按钮后由独立 StartupLoadingView 展示同场景 loading 层。认证成功时发出不含 token 的 guest-authenticated 事件;进度收满并短暂停留后恢复 Signed in successfully. 落点,发出 startup-preparation-ready 事件。
当前没有游戏主场景,不自动跳转;后续游戏场景加载与首屏就绪必须显式接入完成条件,不能把认证成功等同于游戏就绪。详见 startup-loading.md。
点击游客按钮后由独立 StartupLoadingView 展示同场景 loading 层。认证成功时发出不含 token 的 guest-authenticated 事件;默认继续准备游戏,纯认证模式收满后恢复 Signed in successfully. 落点并发出 startup-preparation-ready 事件。
默认等待认证成功、存档恢复和 Orchard 场景依赖后自动切入游戏;关闭 transitionToGame 可保留纯认证模式。详见 startup-loading.md。
## 验证记录
+44
View File
@@ -0,0 +1,44 @@
# Fruit Pop 主游戏
## 运行与界面
- Welcome 保持启动入口。两步游客认证成功后,获取同游客的独占存档权限,恢复本地游戏并加载 Orchard 场景;依赖就绪后 loading 收满并同步切入首屏。
- Orchard 为独立 1080×1920 场景。主界面、5 列裁切窗口、动态数字、8 组弹窗和操作按钮均为已保存的独立节点;运行时更新已有节点,不创建整套 UI。
- 正常状态按主参考图排版。自动状态使用与免费旋转相同结构的 AUTO SPINS/数字/LEFT 横幅,STOP 完成本局后停止。免费状态使用独立 CURRENT WIN/TOTAL WIN 区,锁下注和主按钮。
- 所有新增切图、字体、图集和工程目录均重新命名;assets/orchard 下绑定 81 张切图,符号目录为 emblems,弹窗为 dialogs,字体为 typefaces。amber-numerals.fnt 内 page 指向 amber-glyph-atlas.png,包含 0–9、逗号、小数点。WIN、BET、累计金额和剩余次数使用该字体,钱包白字与英文保持参考样式。
- 每日金币包含可领取与已领取美术状态、UTC 倒计时。帮助页由实际赔率表和赔付线数据生成,不使用整张参考图覆盖。
## 代码职责
- SlotsMath:10 符号权重、20 条固定线、每线最优赔付、SCATTER 及免费列转换。
- GameSession:下注、金币、每日赠币、免费阶段与结算快照;对外读取为深拷贝。
- GameRepository:单 JSON 快照、校验与读回、旧版本冲突及同页重入保护。
- OrchardRuntime:认证游客作用域、均匀加密随机、浏览器独占存档锁和场景预载。
- AutoSpinQueue:尚未开始的普通局队列;不保存或恢复自动旋转。
- OrchardView:输入、三态界面、动画时序及屏幕适配。
- ReelPresentation:只展示已提交结果,离开裁切区后回收符号,中奖线与免费列提示。
- OrchardDialogs:设置、自动配置、每日领取、余额不足、免费触发/结果、规则、错误恢复。
- OrchardAuthoring/OrchardComposer:仅通过显式编辑开关批量排版,保存后节点可独立修改。
## 规则与存档
按根目录 fruit-pop-rules-v1.md 实现。初始 100,000 金币、默认总下注 2,000,普通旋转每局扣一次;结果、扣款、奖金和 pending 在同一快照提交。动画中刷新仅重放 pending,不重抽或重复派奖。
3/4/5 个及以上 SCATTER 分别奖励 8/12/16 次免费旋转。免费局沿用触发下注,每局均匀选择一列,将其中非 SCATTER 转 WILD,不再触发免费。累计只包含免费局奖金,结果窗不重复发钱。
每 UTC 日领取 20,000 一次,旧日期或倒退时钟不能再次领取同一/更早日期。真实权威校时和跨设备同步尚无服务协议,本版为本机金币存档。
真实浏览器入口先取得 Web Locks 独占权限,同游客其他文档不能同时写档。读取损坏或不确定保存会阻止继续并保留原档;确认提示后返回登录重新恢复,不重赠初始金币。需要支持 Web Locks 的安全浏览器环境,当前不支持原生运行。
## 验证
- pnpm@11.17.0 安装,pnpm typecheck 通过,88 项测试通过。
- 包含全部赔付线与普通符号的 3/4/5 连、WILD 最优/全 WILD、SCATTER、列转换、免费锁注、原子扣奖、pending 恢复、坏档/写失败/并发、UTC 日奖、自动队列、字体引用及保存场景契约。
- 发布页真实两步认证进入主游戏,存档恢复保留领取后的余额;服务偶发超时可重试。
- 自动 25 次启动显示剩余 24,STOP 完成本局后停止;每日领取 +20,000,重复点击无二次入账。
- 内存隔离测试存档完整执行免费触发、8 局转换及结果确认,累计与余额增量一致,自动未恢复;未修改真实存档的概率或免费状态。
- 540×960、390×844、390×640、844×390 检查主控件与常用弹窗边界均在可见区域内。
- 同源独立文档共享存储时,已有独占锁使第二文档抢锁失败,存档未变。集成浏览器新顶层页面使用隔离存储,未将它误认为共享存档测试。
- web-mobile 最终交付输出 build/web-mobile-orchard-delivery;发布时包含 Welcome 与 Orchard 两场景。
无音频素材,音乐和音效仅保存偏好,尚无实际音轨;震动按浏览器能力执行。未构建原生包或进行真机测试。规则中的理论 RTP 保持设计值,不代表本轮完成了正式数学认证。
+2 -2
View File
@@ -12,8 +12,8 @@
- GuestLoginView 继续管理按钮绑定和认证生命周期,通过 guest-login-state-changed 发布无会话内容的展示状态。
- StartupProgress 是独立于引擎的进度状态机。等待期间只估算到 90%,不会自行完成;认证成功后用 0.24 秒平滑收满,并显示 100% 至少约 0.12 秒。
- StartupLoadingView 绑定已保存的场景节点,隐藏按钮和页脚,不禁用拥有认证请求的 WelcomeComposition。失败恢复原控件并展示最新错误,可再次点击登录。
- 成功提示在 loading 收尾期间保持隐藏,结束后恢复。组件临时禁用保留待收尾状态,再启用后继续,不重复发送完成通知。
- 当前没有主场景,完成后返回现有认证成功落点,并发送不含 token 的 startup-preparation-ready。后续接游戏场景时,需要让完成条件等待场景加载及首屏实际就绪;当前没有假装预加载不存在的资源。
- 成功提示在 loading 收尾期间保持隐藏,纯认证模式结束后恢复。组件临时禁用会取消准备并忽略迟到结果,再启用后可重新准备,不重复提交认证。
- 默认启用 transitionToGame:收到认证成功事件后获取存档独占权限、恢复会话并加载 Orchard,依赖准备完成才收满并同步切场;失败可用游客按钮单独重试准备,不重复认证。关闭该开关时保留纯认证展示与 startup-preparation-ready。
- 只参考 crimson-lantern 的职责分离、加载上限和真实完成原则,未复制其实现,也未引入原生更新工作流。
## 验证