SuperAPI AI 工具集

phaser4-game-ad-integration

编程与开发

查看项目

更新于 10-16 04:57

技能介绍

用途:面向 Phaser 4 + TypeScript/Vite + Capacitor 移动项目的广告接入,聚合层固定使用 AppLovin MAX,接入固定使用官方 cordova-plugin-applovin-max,由 Capacitor 的 Cordova 兼容层加载;只在 TypeScript 侧建立业务门面和插件 API 适配,不自建原生插件、不直连 MAX SDK。Web、浏览器预览和小游戏不调用 MAX,调用为 no-op。

主要能力:Banner、插页与激励视频广告位管理;插页与激励视频仅后台静默预加载,Banner 不预加载、首次展示时才创建并加载;各广告位独立维护加载失败计数、retry deadline 与至多一个重试 timer,按 2/4/8/16/32/64 秒退避,后台或离线暂停、恢复后继续;全屏就绪判断以官方插件实例就绪属性为准;激励视频 hidden 后对插页设 30 秒保护期,返回 rewarded-interstitial-delay;视频不可用时由统一 UI 层提示一次“视频广告暂不可用,请稍后再试”。

用法:先读取唯一细则合同“AppLovin MAX 接入合同”,并遵守 $phaser4-game-workflow-control 全局控制面。共享门面提供 initialize、retryInitialize、preload、isReady、tryShow、setBannerVisibility 等非阻塞调用,结果含 ok、code、platform、phase、gates 等字段。SDK key 与 ad unit ID 从受控分环境构建配置注入适配层,不写入业务源码、日志或提交记录。

限制:不自动配置 MAX 控制台、广告网络账号、商店元数据或发布渠道;不批准或执行外部写入、付费、真机、商店提交等动作;隐私弹窗固定使用 MAX 自带 Terms and Privacy Policy Flow 及 Google UMP,不另建 CMP。插件版本、兼容性、许可证等需按官方文档核对,缺失处暂未提供。本仓库仅交付 Skill 指导文件,不新增运行时代码、脚本、SDK 依赖或外部配置。