Files
fruit-pop-googleplay/docs/guest-login.md
T

68 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Fruit Pop 游客登录
当前实现登录场景、两步游客认证、本地会话保存、loading 和 Orchard 主游戏。主游戏说明见 orchard-gameplay.md。
## 场景与美术
- 启动场景为 assets/Welcome.scene;项目设计分辨率为 1080×1920。
- WelcomeComposition 下的 BrandMark、FruitArrangement、GuestAccess 是独立可编辑节点。
- 使用未裁剪透明切图,位置和尺寸来自新版 1080×1920 参考图的多尺度像素匹配。
- OrchardBackdrop 使用装饰背景,位于主体之后;长短屏等比覆盖,不拉伸前景。
- Canvas 保存尺寸为 1080×1920,位置为 (540, 960),根 Widget 已取消旧屏幕尺寸对齐。
- GuestReassurance、PrivacyLink、TermsLink 和 LegalDivider 为独立可编辑文字;链接带下划线。
- 导入后的目录和图片已重新命名;原始美术文件保持不变。
- WelcomeViewport 对长屏固定宽度、短屏固定高度,完整保留画布并避免切图变形。
## 模块职责 / Module responsibilities
- GuestContracts:类型、端口与固定错误消息 / Types, ports and fixed error messages.
- GuestSignature:白名单字段的 HMAC-SHA256 签名 / HMAC-SHA256 signing of allowed fields.
- GuestHttpClient:请求、响应、超时和取消 / Requests, responses, deadlines and cancellation.
- GuestSessionStore:独立身份命名空间及会话提交 / Isolated identity namespace and session persistence.
- GuestLoginService:两步认证编排 / Two-step authentication orchestration.
- GuestLoginPresenter:交互状态、防连点及生命周期 / Interaction state, duplicate-click prevention and lifecycle.
- GuestRuntime:连接平台、配置与依赖 / Connect platform capabilities, configuration and dependencies.
- GuestLoginView:场景控件绑定与展示 / Scene bindings and state rendering.
- GuestLegalLinks:法律链接独立交互,未配置网址时仅提示 / Independent legal links with honest missing-URL feedback.
- WelcomeLayoutAuthoring:显式编辑校准,不在运行时生成界面 / Explicit editor calibration without runtime UI generation.
- WelcomeViewport:画布适配 / Viewport adaptation.
## 协议与配置
按已确认要求沿用参考项目 HTTPS 服务、VeryWellSlots 服务端 pkg 与本机签名配置。
本机 common-key/common_key.json 已复制至本项目并加入忽略规则;测试不读取该文件。
1. POST /account/v2/guest/login:携带 X-Timestamp、X-Nonce、X-Sign,不携带 Authorization。
2. POST /account/login:使用同一个 guest_id 与 pkg,不携带签名头,取得完整 token 后保存。
签名使用 LF 分隔的六行,空 uid 为第五行;字段按键排序、false 参与签名、无额外 URL 编码。
每次按钮登录重新认证;游客身份保持不变,nonce 重新生成,不复用缓存 token 作为认证成功。
本地存储前缀为 fruit-pop.auth,按服务地址与产品隔离。重登失败不覆盖旧成功会话。
首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。
点击游客按钮后由独立 StartupLoadingView 展示同场景 loading 层。认证成功时发出不含 token 的 guest-authenticated 事件;默认继续准备游戏,纯认证模式收满后恢复 Signed in successfully. 落点并发出 startup-preparation-ready 事件。
默认等待认证成功、存档恢复和 Orchard 场景依赖后自动切入游戏;关闭 transitionToGame 可保留纯认证模式。详见 startup-loading.md。
## 验证记录
- pnpm@11.17.0 安装;类型检查、离线行为测试与布局契约测试。
- web-mobile 发布构建成功,输出 build/web-mobile-guest-login。
- 发布页真实游客认证:两步接口均 HTTP 200,界面进入认证成功状态,身份与保存会话一致。
- 真实服务存在响应波动,后续一次请求达到超时;按钮恢复可重试,不把失败显示为成功。
- 发布页注入验签失败响应:固定提示、恢复按钮、旧会话保留;测试完成恢复真实网络实现。
- 540×960、390×844、390×640 及横向窗口完成运行时结构检查,切图不拉伸且完整可见。
当前验收范围为网页发布版。没有生成原生子工程或 Android 安装包;原生安全随机、网络适配及真机验证留到对应阶段。
客户端签名材料会进入编译产物;忽略本机文件只防止误提交,不表示客户端密钥不可提取。
## 新版参考图修复
- 改用完整装饰背景,重新校准 Logo、水果和更宽的游客按钮。
- 加入 No account needed 和法律链接;尚无真实政策网址时显示固定提示,不虚构跳转。
- 登录状态提示移至说明文字与法律链接之间。
- 已同步保存画布与项目设计分辨率;类型、布局和行为验证在本轮重新执行。
- 最终发布目录为 build/web-mobile-welcome-revised;类型检查和 15 项测试全部通过。
- 新版发布页两步真实游客认证均返回 HTTP 200,认证完成状态和会话保存通过核对。
- 540×960、390×844、390×640 核对前景完整、不变形、背景覆盖完整;法律链接点击提示正确。
- 自动验收页处于隐藏状态时会暂停帧回调,仅测试页面临时恢复调度;该处理未进入项目代码或构建产物。
- 旧输出目录重建曾因 ENOTEMPTY 失败;改用新的最终目录成功构建,未删除旧产物。