Files
fruit-pop-googleplay/docs/guest-login.md
T
2026-11-20 15:13:11 +08:00

5.1 KiB
Raw Blame History

Fruit Pop 游客登录

本阶段仅实现登录场景、两步游客认证及本地会话保存,不包含加载页或游戏主界面。

场景与美术

  • 启动场景为 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,按服务地址与产品隔离。重登失败不覆盖旧成功会话。 首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。

认证成功后显示 Signed in successfully. 并发出不含 token 的 guest-authenticated 事件,供后续加载功能衔接。 当前不添加加载场景,也不自动跳转。

验证记录

  • 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 失败;改用新的最终目录成功构建,未删除旧产物。