Construct 3 快速上手
FRVR 提供 Construct 3 插件 —— 一个 .zip 文件,装到 Construct 里就会暴露一个普通的 C3 对象,带事件 / 动作 / 条件 / 表达式。
插件覆盖 广告、内购、本地存储、云存储和数据分析。
1. 安装插件
Section titled “1. 安装插件”从 下载页 下载最新的插件 zip —— 例如 frvr-construct-1.0.0.10.zip。
在 Construct 3 里:
Menu → View → Addon Manager → Install new addon…- 选择刚下载的 zip。
- 重启 Construct 3。
2. 添加 FRVR SDK 对象
Section titled “2. 添加 FRVR SDK 对象”在工程里添加一个 FRVR SDK 对象。只有这个对象存在以后,事件表里才会出现 FRVR 的动作 —— 在对象添加之前,Construct 不会暴露 SDK 的动作。
对象添加进工程后,你就能在事件表选择器里看到它下面列出的动作(Show Interstitial、Show Rewarded、Set Local Item、Get Cloud Item、Log Event、Purchase……)。
3. 构建设置
Section titled “3. 构建设置”导出工程时:
除此之外,正常的 Web (HTML5) 导出就可以。
4. 事件表用法
Section titled “4. 事件表用法”- 按钮点击 → FRVR SDK: Show Interstitial
- “Watch Ad” 按下 → FRVR SDK: Show Rewarded
- 收到 FRVR SDK: On reward granted → 发放奖励(只在完整看完时触发)
- 收到 FRVR SDK: On ad skipped → 告诉玩家跳过了 —— 什么都不发
- 收到 FRVR SDK: On ad error → 弹 “暂时没有广告” 并重新启用按钮
插件没有 “rewarded ready” 条件 —— 让按钮一直可点,用 On ad error 处理没库存的情况。详见 广告(Construct 3)。
- 布局开始 → FRVR SDK: Level Start (“level_1”)
- 布局结束 → FRVR SDK: Level End (“level_1”)
- 自定义事件 → FRVR SDK: Log Event (“shop_open”)
- FRVR SDK: Set local item (“coins”, Coins) 持久化到本机。
- FRVR SDK: Set cloud item (“save”, SaveJson) 跨设备同步。
- 用 Get local item / Get cloud item 读取。
- FRVR SDK: Purchase product (“coins_100”)
- 收到 FRVR SDK: On purchase success → 发放物品(读 FRVR SDK.LastPurchase),消耗品要再调 Consume purchase。
- 收到 FRVR SDK: On purchase error → 弹 “再试一次” 的 toast(读 FRVR SDK.LastIAPError)。
- 启动时调 FRVR SDK: Get unconsumed purchases → 在 On unconsumed purchases retrieved 里遍历 FRVR SDK.LastUnconsumedPurchases 并逐一消耗。详见 内购(Construct 3)。
- 选择器里没有动作? 你还没把 FRVR SDK 对象加进工程。加一个就会出现。
- 本地能跑、上线坏? 你忘了在导出对话框里关掉 Offline support。重新导出。
- 广告调用没反应? dev 渠道默认会限制插屏频率(约 5 分钟一次,开头约 100 秒内被屏蔽)。激励广告没库存时会触发 On ad error 而不是弹出任何东西 —— 把这个触发器接上才看得见。
按常规导出即可(Menu → Project → Export → Web (HTML5))。FRVR 的发布流水线会按平台分别打包并注入对应的渠道包 —— 你不需要在工程里引用任何生产渠道。