MatchMaster/docs/home-popup-queue.md

14 lines
1.6 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.

# HomeScene 自动弹窗队列
脚本目录:`assets/home_popup_queue`。这是主包中的独立代码目录(不是资源 Bundle),供主页和七日活动 Host 共用。不要把它改成远程分包,否则主包静态依赖会破坏按需加载。
当前接入的自动展示顺序:七日活动(10)、月卡每日奖励(20)、月卡购买(30)、新手礼包(40)、连胜(50)。数字越小优先级越高。优先级适用于已经进入队列的任务,不抢占正在展示的窗口;接口稍后返回时仍遵守该规则。
队列在下一帧选取任务。七日、礼包和连胜资源加载期间占用队列;失败释放占用。展示后检查实际节点状态,活动节点和公共 RewardNode 都关闭才继续。月卡购买的当天记录在节点成功显示后写入。
转移窗口显示时暂停队列。已有通行证、丛林宝藏窗口也会阻止队列推进,但它们自己的异步自动打开流程尚未改为入队,因此当前并非所有 HomeScene 弹窗都由本队列调度。分享、订单补发同样仍沿用原流程。后续接入应在资源/接口异步结束时显式结束加载阶段,不能使用固定延时猜测窗口加载完成。
手动入口沿用原行为。队列随 Canvas 销毁,未展示任务不会跨场景继续执行。
验证:已用引擎桩验证优先级、同键去重、资源加载占用、活动与公共奖励关闭前不推进。需要微信开发版回归:七日与月卡同时满足条件、月卡先打开再返回七日接口、领取后先关闭活动但奖励还在、分包失败、退出 HomeScene。