SuperAPI AI 工具集

game-client

编程与开发

查看项目

更新于 11-15 03:09

技能介绍

该技能专注于游戏客户端开发,负责从服务器状态到屏幕渲染之间的全部工作:绘制世界、采集输入、管理资源与性能。它假设多人游戏中服务器拥有权威状态,预测、和解与插值由 game-state-sync 处理,客户端仅作为展示与输入层。

用途

帮助开发者在 Bun + TypeScript 环境下,为浏览器游戏选择合适的技术栈并搭建客户端基础架构。覆盖范围包括:技术栈选型、固定步长循环与引擎帧循环的协调、输入管理(键盘、指针、触摸、手柄)、音频解锁、Canvas 尺寸与设备像素比适配、WebGL/WebGPU 上下文丢失恢复、资源加载与释放、性能预算控制。

主要能力

  1. 技术栈选型指导:对比原生 Web(Canvas 2D/WebGL2/WebGPU)、Phaser 4、PixiJS 8、Three.js 和 React Three Fiber,给出各自适用与避免的场景。
  2. Bun 与 TypeScript 环境配置:原生 Web 使用 bun ./index.html 提供热重载,bun build ./index.html --outdir=dist 构建;Phaser/PixiJS 模板使用 Vite 打包,Bun 作为包管理器和运行时;Three.js 需安装同版本的 three 与 @types/three;R3F 需匹配 React 主版本(fiber 9 需要 React 19)。建议为客户端单独配置 tsconfig,包含 "DOM" 库。
  3. 循环与时序:模拟采用固定步长,由 game-state-sync 的 ClientGameLoop 负责(基于 requestAnimationFrame 的累加器、每帧 250ms 上限、每个 tick 预测、两 tick 间 alpha)。帧移动必须基于流逝时间,不能使用固定量。引擎驱动模式下(Phaser/PixiJS/Three.js/R3F),在引擎每帧钩子中调用 loop.step(now) 获取 alpha,再通过 loop.getRenderState() 读取前后状态,将变换写入显示对象。
  4. 可见性暂停与重同步:标签页隐藏时停止客户端循环、清除输入、暂停音频;恢复时丢弃过期插值快照,请求完整快照,然后重启循环,避免回放整个空档。提供 boilerplate/visibility-resync.ts 样板。
  5. 输入管理:键盘使用 KeyboardEvent.code(物理键位,适配非 QWERTY 布局),忽略 repeat 事件,窗口失焦时清除按键;指针事件统一处理鼠标/触控笔/触摸,使用 setPointerCapture,pointercancel 视同 pointerup;触摸手势设置 touch-action: none;手柄每 tick 轮询 navigator.getGamepads(),每次重新读取列表。提供 boilerplate/input-manager.ts 无框架实现。
  6. 音频解锁:AudioContext 需在用户手势后调用 resume(),仅 keydown、mousedown、来自触摸或触控笔的 pointerup、touchend 算激活事件,触摸 pointerdown 不算。提供 boilerplate/audio-unlock.ts。
  7. Canvas 尺寸与设备像素比:使用 ResizeObserver 的 { box: 'device-pixel-content-box' } 获取精确设备像素,回退到 CSS 尺寸乘以 devicePixelRatio,并限制比率上限。提供 boilerplate/canvas-size.ts,支持 devicePixelRatio 变化时重新应用。
  8. 上下文丢失处理:在 webglcontextlost 中调用 event.preventDefault() 并停止渲染;在 webglcontextrestored 中重建所有纹理、缓冲区、着色器和程序。WebGPU 监听 device.lost。
  9. 资源加载与释放:按场景加载并显示进度;场景结束时释放 GPU 资源(three.js 的 dispose、PixiJS 的 Assets.unload 和 destroy、Phaser 的 textures.remove、原生 Web 的 ImageBitmap.close 和 WebGL 删除)。使用纹理图集,单边纹理建议不超过 4096px。
  10. 性能预算:帧预算为一次显示刷新(60Hz 下 16.7ms,120Hz 下 8.3ms);绘制调用控制在几百次以内;使用位图文本更新每帧变化的文本;帧循环中避免分配;避免在帧循环中调用 getError/getParameter。

使用方式

先根据项目需求从技术栈对比表中选择一个栈,然后只阅读对应的参考文件(web.md、phaser.md、pixijs.md 或 three.md),跳过其余。根据所选栈使用对应的 Bun 命令或模板初始化项目。按需复制 boilerplate 中的样板代码(input-manager.ts、visibility-resync.ts、audio-unlock.ts、canvas-size.ts)。引擎驱动模式下需遵循各引擎的帧循环集成规则,不重复创建固定步长循环。

适用场景

  • 使用 Bun + TypeScript 开发浏览器游戏客户端。
  • 需要为 2D 或 3D 游戏选择渲染技术栈。
  • 需要处理跨平台输入(键盘、鼠标、触摸、手柄)。
  • 需要处理标签页可见性变化后的状态重同步。
  • 需要优化 Canvas 高分屏渲染、资源管理和性能。

限制

  • 该技能不负责服务器架构和状态同步逻辑,相关部分由 game-state-sync 和 game-backend-architecture 技能处理。
  • 各引擎的参考文件基于特定版本(Phaser 4.2.1、PixiJS 8.23.0、three 0.187.0、@react-three/fiber 9.8.2),旧版本代码可能不适用。
  • 技能提供的规则和样板代码需结合具体项目调整,不保证开箱即用。
  • 文档未提供关于收费、价格、平台支持范围或效果保证的信息。
  • 部分内容引用其他技能(如 ui-ux-game、elevenlabs-sound-music、level-design 等),需另行获取。