SuperAPI AI 工具集

remix-game-sdk

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:这是 Remix 托管游戏所用的 @remix-gg/sdk 运行时参考,用于生成或修复游戏代码、商店道具集成、存档流程与多人钩子。

运行环境:在 Remix 托管上传中,SDK 通过 window.RemixSDK 提供;window.FarcadeSDK 仍作为向后兼容别名保留,但新代码应使用 window.RemixSDK。单文件游戏上传代码不应依赖包导入,需在 HTML 的 head 中引入脚本:https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js。

必要用法:读取玩家或游戏数据前必须 await window.RemixSDK.ready()。v1 智能体验证要求实现三个钩子:singlePlayer.actions.gameOver({ score })、onPlayAgain(() => {...})、onToggleMute(({ isMuted }) => {...})。

主要能力:提供 player、players、gameState、gameInfo、purchasedItems、inventory、shopItems、isReady 等属性/取值器,以及 hasItem(itemId)、getItemPurchaseCount(itemId)、getShopItem(slug)。gameInfo 含 viewContext(信息流/全屏/挑战/锦标赛上下文)、contentSafeAreaInset(移动端覆盖层安全布局)、initialGameState(持久化状态注水)。单人操作包括 gameOver、saveGameState、purchase、onPurchaseComplete、reportError、hapticFeedback;多人操作包括 multiplayer.actions.gameOver({ scores }) 与 onGameStateUpdated(callback),多人部分为可选。

限制与常见错误:不要在 ready() 完成前调用取值器;不要遗漏任一必需验证钩子;不存在 vibrate、checkpoint、save 等方法;新代码应使用 sdk.purchase(...) 而非 singlePlayer.actions.purchase(...);HUD 或控件需考虑 contentSafeAreaInset;持久化应使用 saveGameState,而非 localStorage/sessionStorage。更多细节官网暂未提供。