remix-game-best-practices

游戏创建最佳实践

移动端优先要求

• 仅针对竖屏方向构建。
• 画布必须为 720x1080（宽高比为 2:3）。
• 不要使用横屏布局或控件。
• 设计便于拇指操作且界面清晰易读。

必须使用 Remix SDK

在 HTML <head> 中包含 SDK 脚本：

• <script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>

仅使用受支持的 SDK API：

• window.RemixSDK.singlePlayer.actions.saveGameState({ gameState: {...} })
• window.RemixSDK.singlePlayer.actions.gameOver({ score: number })
• window.RemixSDK.onPlayAgain(() => { ... })
• window.RemixSDK.onToggleMute((data) => { ... })
• window.RemixSDK.ready()
• window.RemixSDK.gameState
• window.RemixSDK.hapticFeedback()

禁止的 API 和模式

• 不要使用 localStorage。
• 不要使用 sessionStorage。
• 不要使用 navigator.vibrate(...)。
• 不要使用 window.RemixSDK.vibrate(...)。
• 不要使用不存在的 SDK 方法（如 save、checkpoint 等）。

游戏结束与重启流程

• 仅通过以下方式结束游戏回合：

window.RemixSDK.singlePlayer.actions.gameOver({ score: finalScore })

• 不要实现自定义的游戏结束画面。
• 通过 window.RemixSDK.onPlayAgain(...) 处理重玩。

状态持久化

• 仅使用 saveGameState 持久化进度。
• 在 await window.RemixSDK.ready() 之后，从 window.RemixSDK.gameState 读取持久化的值。
• 保存的状态应精简且可序列化。

触觉反馈与音频

• 在碰撞、得分、UI 交互和游戏结束时使用 window.RemixSDK.hapticFeedback()。
• 所有游戏音频都应遵循 onToggleMute 状态。
• 使用轻量级 Web Audio API 音效，以提升移动端性能。

框架规则

Phaser（2D）

• 使用全局变量 Phaser（不使用导入）。
• 使用场景生命周期（preload、create、update）。
• 使用 Arcade 物理引擎处理碰撞。
• 不要在 Phaser.Game 配置中设置 parent。

Three.js + Cannon-ES（3D）

• 使用全局变量 THREE 和 CANNON（不使用导入）。
• 使用 requestAnimationFrame 循环。
• 包含环境光和方向光。
• 每帧都从物理刚体同步网格变换。

代码与运行时限制

• 仅编写 ES6 JavaScript（不使用 TypeScript）。
• 不要使用 import 语句。
• 假设运行环境仅限浏览器（不使用 Node.js API）。
• 定义 initGame() 并在文件末尾调用。

验证清单

完成游戏前，请确认：

• 画布为竖屏 2:3（720x1080）。
• 已包含 SDK 钩子（gameOver、onPlayAgain、onToggleMute）。
• 未使用任何被禁止的存储或振动 API。
• 已为有意义的游戏事件集成触觉反馈。
• 可通过 onPlayAgain 正常完成重启流程。