该技能专注于游戏客户端开发,负责从服务器状态到屏幕渲染之间的全部工作:绘制世界、采集输入、管理资源与性能。它假设多人游戏中服务器拥有权威状态,预测、和解与插值由 game-state-sync 处理,客户端仅作为展示与输入层。
用途
帮助开发者在 Bun + TypeScript 环境下,为浏览器游戏选择合适的技术栈并搭建客户端基础架构。覆盖范围包括:技术栈选型、固定步长循环与引擎帧循环的协调、输入管理(键盘、指针、触摸、手柄)、音频解锁、Canvas 尺寸与设备像素比适配、WebGL/WebGPU 上下文丢失恢复、资源加载与释放、性能预算控制。
主要能力
- 技术栈选型指导:对比原生 Web(Canvas 2D/WebGL2/WebGPU)、Phaser 4、PixiJS 8、Three.js 和 React Three Fiber,给出各自适用与避免的场景。
- 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"库。 - 循环与时序:模拟采用固定步长,由 game-state-sync 的 ClientGameLoop 负责(基于 requestAnimationFrame 的累加器、每帧 250ms 上限、每个 tick 预测、两 tick 间 alpha)。帧移动必须基于流逝时间,不能使用固定量。引擎驱动模式下(Phaser/PixiJS/Three.js/R3F),在引擎每帧钩子中调用
loop.step(now)获取 alpha,再通过loop.getRenderState()读取前后状态,将变换写入显示对象。 - 可见性暂停与重同步:标签页隐藏时停止客户端循环、清除输入、暂停音频;恢复时丢弃过期插值快照,请求完整快照,然后重启循环,避免回放整个空档。提供
boilerplate/visibility-resync.ts样板。 - 输入管理:键盘使用
KeyboardEvent.code(物理键位,适配非 QWERTY 布局),忽略 repeat 事件,窗口失焦时清除按键;指针事件统一处理鼠标/触控笔/触摸,使用setPointerCapture,pointercancel视同pointerup;触摸手势设置touch-action: none;手柄每 tick 轮询navigator.getGamepads(),每次重新读取列表。提供boilerplate/input-manager.ts无框架实现。 - 音频解锁:AudioContext 需在用户手势后调用
resume(),仅 keydown、mousedown、来自触摸或触控笔的 pointerup、touchend 算激活事件,触摸 pointerdown 不算。提供boilerplate/audio-unlock.ts。 - Canvas 尺寸与设备像素比:使用 ResizeObserver 的
{ box: 'device-pixel-content-box' }获取精确设备像素,回退到 CSS 尺寸乘以 devicePixelRatio,并限制比率上限。提供boilerplate/canvas-size.ts,支持 devicePixelRatio 变化时重新应用。 - 上下文丢失处理:在
webglcontextlost中调用event.preventDefault()并停止渲染;在webglcontextrestored中重建所有纹理、缓冲区、着色器和程序。WebGPU 监听device.lost。 - 资源加载与释放:按场景加载并显示进度;场景结束时释放 GPU 资源(three.js 的 dispose、PixiJS 的 Assets.unload 和 destroy、Phaser 的 textures.remove、原生 Web 的 ImageBitmap.close 和 WebGL 删除)。使用纹理图集,单边纹理建议不超过 4096px。
- 性能预算:帧预算为一次显示刷新(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 等),需另行获取。