jakciehan
235 lines
13 KiB
Markdown
235 lines
13 KiB
Markdown
# 实施计划：坦克大作战商业化
|
||
|
||
> 基于 [requirements.md](./requirements.md) 商业化需求文档，按版本阶段拆解为可执行的编码任务。
|
||
|
||
---
|
||
|
||
## V1.0 基础版 — 激励广告 + 插屏广告
|
||
|
||
- [ ] 1. 扩展 AdManager，实现场景化广告触发与频控机制
|
||
- [ ] 1.1 在 `js/managers/AdManager.js` 中新增广告场景枚举（REVIVE、DOUBLE_REWARD、CHEST_SPEED、STAMINA、FREE_GIFT），为每个场景维护独立的冷却计时器（15分钟内不重复展示同一场景广告）
|
||
- 新增 `_sceneCooldowns` Map 和 `canShowScene(sceneType)` 方法
|
||
- 新增 `showRewardedVideoForScene(sceneType, callback)` 方法，内部调用 `canShowScene` 检查后再调用 `showRewardedVideo`
|
||
- 新增每日广告次数计数（体力恢复场景每日上限5次），使用 StorageManager 持久化当日计数
|
||
- _需求：1.6 广告体验优化（验收标准15、16、17）、1.4 体力恢复广告（验收标准12）_
|
||
|
||
- [ ] 1.2 在 `js/managers/AdManager.js` 中实现广告预加载机制
|
||
- 新增 `preloadRewardedVideo()` 方法，在关卡加载时提前调用
|
||
- 在 GameScene 和 TeamGameScene 的初始化阶段调用预加载
|
||
- _需求：1.6 广告体验优化（验收标准15）_
|
||
|
||
- [ ] 1.3 优化插屏广告频控逻辑
|
||
- 将现有的 `_gamesPlayed` 计数改为基于"距上次展示的局数"判断（每3局展示一次）
|
||
- 确保 `_adFreeEnabled` 标志正确跳过所有插屏广告
|
||
- 插屏广告加载失败时静默跳过，不阻塞流程
|
||
- _需求：2 插屏广告（验收标准1、2、3、4）_
|
||
|
||
- [ ] 2. 实现复活续关广告功能
|
||
- [ ] 2.1 在 `js/scenes/GameScene.js` 的玩家死亡流程中集成复活广告
|
||
- 在玩家生命数降为0时，弹出"观看广告复活"弹窗（而非直接进入失败结算）
|
||
- 新增 `_showReviveAdDialog()` 方法，展示选择界面（观看广告 / 放弃）
|
||
- 新增 `_reviveAdUsed` 标志，确保每关最多使用1次复活
|
||
- 观看完成后调用 `_revivePlayer()` 方法：保留火力等级，在出生点重生，恢复1条生命
|
||
- 选择放弃或广告不可用时，正常进入失败结算
|
||
- _需求：1.1 复活续关广告（验收标准1、2、3、4）_
|
||
|
||
- [ ] 2.2 在 `js/scenes/TeamGameScene.js` 中同步实现 PvP 模式的复活广告（如适用）
|
||
- 根据 PvP 模式规则决定是否支持复活广告（可配置开关）
|
||
- _需求：1.1 复活续关广告（验收标准1）_
|
||
|
||
- [ ] 3. 实现双倍结算广告功能
|
||
- [ ] 3.1 在 `js/scenes/ResultScene.js` 的结算界面中添加"双倍奖励"按钮
|
||
- 在结算界面新增"观看广告获得双倍奖励"按钮
|
||
- 调用 `AdManager.showRewardedVideoForScene('DOUBLE_REWARD', callback)`
|
||
- 观看完成后将金币和经验值翻倍显示并发放
|
||
- 广告加载失败时提示"广告暂时不可用"，按正常倍率发放
|
||
- _需求：1.2 双倍结算广告（验收标准5、6、7）_
|
||
|
||
- [ ] 3.2 在 `js/scenes/TeamResultScene.js` 中同步实现 PvP 结算的双倍奖励广告
|
||
- _需求：1.2 双倍结算广告（验收标准5、6、7）_
|
||
|
||
- [ ] 4. 在结算流程中集成插屏广告触发
|
||
- 在 ResultScene 和 TeamResultScene 退出关卡时调用 `AdManager.showInterstitial()`
|
||
- 确保去广告特权用户不展示
|
||
- _需求：2 插屏广告（验收标准1、2、3）_
|
||
|
||
---
|
||
|
||
## V1.5 内购版 — 货币体系 + 支付 + 皮肤商店
|
||
|
||
- [ ] 5. 实现货币系统（CurrencyManager）
|
||
- [ ] 5.1 新建 `js/managers/CurrencyManager.js`，实现金币和钻石的管理
|
||
- 实现 `getGold()` / `addGold(amount)` / `spendGold(amount)` 方法
|
||
- 实现 `getDiamonds()` / `addDiamonds(amount)` / `spendDiamonds(amount)` 方法
|
||
- 所有货币变动通过 EventBus 发送事件（`currency:gold:changed`、`currency:diamonds:changed`），供 UI 监听更新
|
||
- 使用 StorageManager 持久化货币数据，并纳入云同步数据
|
||
- 设置货币上限防止溢出（金币上限999999，钻石上限99999）
|
||
- _需求：3.1 金币系统（验收标准1、2、3）、3.2 钻石系统（验收标准5、6、7）_
|
||
|
||
- [ ] 5.2 在 `js/base/GameGlobal.js` 中注册 CurrencyManager 实例
|
||
- 在全局初始化流程中创建并挂载 `GameGlobal.currencyManager`
|
||
- _需求：3.1、3.2_
|
||
|
||
- [ ] 5.3 在 ResultScene / TeamResultScene 的结算逻辑中集成金币发放
|
||
- 根据击杀数、通关时间等计算金币奖励并调用 `CurrencyManager.addGold()`
|
||
- _需求：3.1 金币系统（验收标准1）_
|
||
|
||
- [ ] 6. 实现体力系统（StaminaManager）
|
||
- [ ] 6.1 新建 `js/managers/StaminaManager.js`，实现体力管理
|
||
- 实现 `getStamina()` / `consumeStamina()` / `recoverStamina(amount)` 方法
|
||
- 实现自然恢复逻辑：每6分钟恢复1点，上限20点，使用定时器 + 离线时间差计算
|
||
- 实现钻石购买体力：每日上限3次，价格递增（5/10/20钻石）
|
||
- 实现广告恢复体力：每次恢复5点，每日上限5次
|
||
- 通过 EventBus 发送 `stamina:changed` 事件
|
||
- 使用 StorageManager 持久化体力值和上次恢复时间戳
|
||
- _需求：8 体力系统（验收标准1、2、3、4、5）、1.4 体力恢复广告（验收标准10、11、12）_
|
||
|
||
- [ ] 6.2 在 GameScene 开始关卡前检查体力
|
||
- 进入经典模式/无尽模式前调用 `StaminaManager.consumeStamina()`
|
||
- 体力不足时弹出恢复选项弹窗（等待/广告/钻石）
|
||
- PvP 模式（TeamGameScene）不消耗体力
|
||
- _需求：8 体力系统（验收标准1、2、5）_
|
||
|
||
- [ ] 7. 实现支付模块（PaymentManager）
|
||
- [ ] 7.1 新建 `js/managers/PaymentManager.js`，封装微信支付接口
|
||
- 封装 `wx.requestMidasPayment` 调用，实现 `purchase(productId, callback)` 方法
|
||
- 实现订单状态查询和补发逻辑（网络中断后自动重试）
|
||
- 实现商品配置表：去广告特权（¥30）、月卡（¥12）、钻石包（¥6/¥30/¥68）、新手礼包（¥1）、皮肤礼包（¥18-68）、高级通行证（¥18）
|
||
- 购买成功后通过 EventBus 发送 `purchase:completed` 事件
|
||
- 将购买记录同步至 StorageManager 和云端
|
||
- _需求：4.6 支付与安全（验收标准15、16、17）_
|
||
|
||
- [ ] 7.2 实现去广告特权购买逻辑
|
||
- 购买成功后调用 `AdManager.enableAdFree()`
|
||
- 保留激励视频入口，仅移除插屏广告
|
||
- _需求：4.1 去广告特权（验收标准1、2、3）_
|
||
|
||
- [ ] 7.3 实现钻石充值包购买逻辑
|
||
- 按规格发放钻石（60/360/880），首充双倍
|
||
- 使用 StorageManager 记录首充状态
|
||
- _需求：4.3 钻石充值包（验收标准8、9）_
|
||
|
||
- [ ] 7.4 实现新手礼包逻辑
|
||
- 新用户首次进入游戏后24小时内展示购买入口
|
||
- 倒计时结束后自动移除入口
|
||
- _需求：4.5 新手礼包（验收标准13、14）_
|
||
|
||
- [ ] 8. 实现皮肤系统与商店场景
|
||
- [ ] 8.1 新建 `js/data/SkinData.js`，定义皮肤配置数据
|
||
- 定义皮肤分类（基础/高级/限定）、价格（金币/钻石）、获取途径、皮肤资源映射
|
||
- _需求：7 皮肤商店系统（验收标准1、5）_
|
||
|
||
- [ ] 8.2 新建 `js/managers/SkinManager.js`，实现皮肤解锁与装备管理
|
||
- 实现 `getOwnedSkins()` / `unlockSkin(skinId)` / `equipSkin(skinId)` / `getCurrentSkin()` 方法
|
||
- 使用 StorageManager 持久化已解锁皮肤和当前装备
|
||
- 纳入云同步数据
|
||
- _需求：7 皮肤商店系统（验收标准2、3、4）_
|
||
|
||
- [ ] 8.3 新建 `js/scenes/ShopScene.js`，实现商店界面
|
||
- 展示皮肤列表（分类标签页：基础/高级/限定）
|
||
- 展示皮肤预览、价格、购买/装备按钮
|
||
- 集成 CurrencyManager 扣款和 SkinManager 解锁
|
||
- 展示去广告特权、钻石充值包等 IAP 商品入口
|
||
- _需求：7 皮肤商店系统（验收标准1、2、5）、4.1、4.3_
|
||
|
||
- [ ] 8.4 在 `js/scenes/MenuScene.js` 中添加商店入口按钮
|
||
- 点击后通过 SceneManager 跳转到 ShopScene
|
||
- _需求：7 皮肤商店系统_
|
||
|
||
- [ ] 8.5 在 Tank 渲染逻辑中集成皮肤系统
|
||
- 修改 `js/entities/Tank.js` 或 `PlayerTank.js`，根据 `SkinManager.getCurrentSkin()` 加载对应皮肤资源
|
||
- _需求：7 皮肤商店系统（验收标准3）_
|
||
|
||
---
|
||
|
||
## V2.0 赛季版 — 战斗通行证 + 任务体系
|
||
|
||
- [ ] 9. 实现战斗通行证系统（BattlePassManager）
|
||
- [ ] 9.1 新建 `js/data/BattlePassData.js`，定义赛季配置
|
||
- 定义赛季时长（28天）、等级数（免费20级/高级40级）、每级奖励内容
|
||
- 定义每日任务池、每周任务池、赛季成就列表及对应经验值
|
||
- _需求：5.1 赛季基础设计（验收标准1、2、3）、5.2 任务体系（验收标准5、6、7）_
|
||
|
||
- [ ] 9.2 新建 `js/managers/BattlePassManager.js`，实现通行证核心逻辑
|
||
- 实现赛季状态管理：当前赛季ID、开始/结束时间、玩家等级、经验值
|
||
- 实现 `addExp(amount)` / `getLevel()` / `claimReward(level)` 方法
|
||
- 实现免费/高级通行证奖励轨道区分
|
||
- 实现任务生成与完成追踪（每日3+2任务、每周5+3任务、赛季10成就）
|
||
- 赛季结束时保留赛季币余额，提供3天奖励领取缓冲期
|
||
- 使用 StorageManager 持久化赛季进度
|
||
- _需求：5.1（验收标准1、2、3、4）、5.2（验收标准5、6、7、8）_
|
||
|
||
- [ ] 9.3 新建 `js/scenes/BattlePassScene.js`，实现通行证界面
|
||
- 展示等级进度条、免费/高级奖励轨道
|
||
- 展示每日任务、每周任务、赛季成就列表及完成状态
|
||
- 高级通行证购买入口（集成 PaymentManager）
|
||
- 免费玩家达到10级时展示高级版奖励预览
|
||
- 赛季剩余不足3天时展示8折优惠
|
||
- _需求：5.1（验收标准2、3、4）、5.3 转化策略（验收标准9、10）_
|
||
|
||
- [ ] 9.4 在 MenuScene 中添加通行证入口，在 GameScene/TeamGameScene 结算时触发任务进度更新
|
||
- 对局结束后检查并更新任务完成状态（如"击杀N个敌人"、"通关N次"等）
|
||
- _需求：5.2 任务体系（验收标准8）_
|
||
|
||
- [ ] 10. 实现月卡系统
|
||
- [ ] 10.1 在 `js/managers/PaymentManager.js` 中新增月卡购买与状态管理
|
||
- 实现月卡有效期检查、每日登录领取100钻石、专属头像框解锁/过期
|
||
- 使用 StorageManager 记录月卡购买时间和每日领取状态
|
||
- _需求：4.2 月卡（验收标准4、5、6）_
|
||
|
||
- [ ] 10.2 在游戏启动流程中检查月卡状态并弹出每日领取弹窗
|
||
- _需求：4.2 月卡（验收标准5）_
|
||
|
||
---
|
||
|
||
## V2.5 社交版 — 分享裂变 + 付费引导 + 合规
|
||
|
||
- [ ] 11. 扩展 ShareManager，实现分享激励体系
|
||
- [ ] 11.1 在 `js/managers/ShareManager.js` 中新增分享奖励逻辑
|
||
- 每日首次分享发放50金币（通过 CurrencyManager）
|
||
- 分享战绩概率发放稀有道具，每日上限3次
|
||
- 使用 StorageManager 记录每日分享次数和奖励领取状态
|
||
- _需求：6.1 分享激励（验收标准1、4）_
|
||
|
||
- [ ] 11.2 实现邀请新用户奖励机制
|
||
- 新用户完成新手引导后，向邀请者发放200金币（每日上限5人）
|
||
- 新用户获得双倍经验卡（3天有效期）
|
||
- 实现 IP + 设备指纹去重防作弊（服务端校验）
|
||
- _需求：6.1 分享激励（验收标准2、3）、6.2 防作弊机制（验收标准6、7）_
|
||
|
||
- [ ] 12. 实现付费节奏引导系统
|
||
- [ ] 12.1 新建 `js/managers/PromotionManager.js`，实现生命周期付费引导
|
||
- 根据玩家累计登录天数判断所处阶段（新手期/成长期/成熟期）
|
||
- 新手期（1-3天）：展示新手礼包弹窗（最多3次）、去广告特权推荐
|
||
- 成长期（4-14天）：高亮月卡推荐、钻石充值促销（限时加赠20%）
|
||
- 成熟期（15天+）：推送通行证购买引导、限量皮肤预告
|
||
- 使用 StorageManager 记录弹窗展示次数和登录天数
|
||
- _需求：9.1（验收标准1、2）、9.2（验收标准3、4）、9.3（验收标准5、6）_
|
||
|
||
- [ ] 12.2 在 `game.js` 启动流程和 MenuScene 中集成 PromotionManager 的引导触发
|
||
- 登录时检查阶段并展示对应引导弹窗
|
||
- _需求：9 付费节奏与引导_
|
||
|
||
- [ ] 13. 实现未成年人保护与合规机制
|
||
- [ ] 13.1 新建 `js/managers/ComplianceManager.js`，实现合规检查
|
||
- 实现未成年人识别（调用微信平台用户年龄信息接口）
|
||
- 实现游戏时间限制：22:00-8:00禁止未成年人登录
|
||
- 实现消费限制：月消费上限¥400，单次>¥50弹出确认
|
||
- 实现广告展示限制：未成年人每日广告不超过5次
|
||
- _需求：10.1 未成年人保护（验收标准1、2、3）_
|
||
|
||
- [ ] 13.2 在宝箱/抽奖等随机奖励界面添加概率公示
|
||
- 在对应 UI 中明确展示所有物品的掉落概率
|
||
- _需求：10.2 概率公示（验收标准4）_
|
||
|
||
- [ ] 13.3 在服务端 `server/index.js` 中新增反作弊检测逻辑
|
||
- 广告反刷：同一IP短时间大量请求时限制广告展示
|
||
- 异常充值检测：大额充值触发人工审核标记
|
||
- 对局数据校验：异常击杀数/速度标记封禁
|
||
- _需求：10.4 反作弊（验收标准7、8、9）_
|
||
|
||
- [ ] 14. 国际化支持：为所有商业化 UI 文案添加 i18n 翻译
|
||
- 在 `js/i18n/zh.js` 和 `js/i18n/en.js` 中新增商店、通行证、体力、货币、弹窗等所有商业化相关的翻译键值
|
||
- 确保所有新增场景和弹窗使用 `I18n.t()` 获取文案
|
||
- _需求：全部商业化需求的 UI 文案_
|