用途:在创建 Phaser 4 游戏实例或配置 GameConfig 时使用,帮助选择渲染器、设置画布与缩放、像素画、FPS 及画布挂载位置。
主要能力:new Phaser.Game(config) 会触发配置解析、渲染器创建、DOM 插入与游戏循环。渲染器常量包括 Phaser.AUTO(0,优先 WebGL 否则回退 Canvas)、Phaser.CANVAS(1)、Phaser.WEBGL(2,无回退)、Phaser.HEADLESS(3,仅用于单元测试)。可配置像素画(pixelArt 自动关闭抗锯齿并开启 roundPixels)、smoothPixelArt(仅 WebGL)、响应式缩放(FIT、RESIZE、ENVELOP、EXPAND 等模式与居中、缩放常量)、FPS(target 仅提示,limit 才真正限帧)、透明画布、已有 canvas 元素、多场景、启动回调、输入子系统开关等。
使用方式:定义 config 对象后调用 new Phaser.Game(config);游戏会等待 DOMContentLoaded 再启动。可通过 game.events 监听 blur、focus、hidden、visible、pause、resume,用 game.pause()/resume() 控制循环,用 game.destroy(removeCanvas, noReturn) 销毁(异步,监听 DESTROY 事件)。
限制与注意:scale 子对象优先于顶层同名配置;Phaser.WEBGL 无回退;parent 为 null 时不自动插入 DOM;transparent 会覆盖 backgroundColor;fps.limit 只能降速不能提速;smoothPixelArt 仅 WebGL 有效;dom.createContainer 需要 parent。v4 默认尺寸改为 1024×768,新增 EXPAND 模式、smoothPixelArt、renderNodes、skipUnreadyShaders 等。