跳转到内容

Game View

Game View 是编辑器中的游戏预览面板,提供播放控制、分辨率模拟、实时属性编辑和运行时调试功能。你可以在不离开编辑器的情况下快速验证和调整游戏逻辑。

启动预览

点击工具栏左侧的 Play 按钮启动游戏预览。编辑器会启动预览服务器并加载当前项目。

点击 Stop 按钮停止预览,Game View 会回到初始的空白状态,编辑器恢复到正常编辑模式。

共享 Canvas

Scene View 和 Game View 共享同一个离屏 WebGL Canvas。预览启动后,两个视图从同一渲染管线输出——Scene View 显示带 Gizmo 的编辑器视口,Game View 显示游戏相机画面。这避免了 WASM 实例的重复创建,保持较低的内存占用。

播放控制

工具栏提供以下播放控制按钮:

按钮功能
Play启动游戏预览
Pause暂停游戏运行,保持画面冻结
Resume从暂停状态恢复运行
Step Frame暂停状态下单步执行一帧,适合逐帧调试
Stop停止预览,销毁游戏实例

播放速度

工具栏中的速度下拉菜单支持调整游戏运行速度:

  • 0.25x — 四分之一速度,适合观察快速动画
  • 0.5x — 半速
  • 1x — 正常速度(默认)
  • 2x — 两倍速
  • 4x — 四倍速,适合快速跳过等待阶段

速度调整会实时生效,无需重启预览。

分辨率设置

工具栏中的分辨率下拉菜单提供多种预设分辨率,用于模拟不同设备的屏幕尺寸:

预设分辨率
Free自适应面板大小
16:91920 x 1080
9:161080 x 1920
4:31024 x 768
3:4768 x 1024
Custom自定义宽高

选择 Free 时,游戏画面会填满整个 Game View 区域。选择固定分辨率时,游戏画面会按照目标宽高比等比缩放,在 Game View 区域内居中显示。

选择 Custom 后会出现宽度和高度输入框,支持输入 1 到 7680 之间的任意分辨率值。

Play Mode

启动预览后,编辑器进入 Play Mode。这是一个特殊的运行时调试模式,Hierarchy 面板和 Inspector 面板会切换到运行时视图。

状态快照

进入 Play Mode 时,编辑器会对当前场景拍摄完整快照——包括实体树、组件数据、选择状态和修改标记。停止预览时,快照会被恢复,所有运行时修改都会被丢弃。这意味着你可以在播放期间自由实验,不会影响已保存的场景。

Hierarchy 面板

进入 Play Mode 后,Hierarchy 面板会发生以下变化:

  • 面板顶部出现蓝色边框,工具栏右侧显示蓝色 RUNTIME 标记
  • 实体树切换为运行时实体列表,显示游戏中实际存在的所有实体
  • 运行时动态生成的实体(如子弹、特效)也会出现在列表中
  • 工具栏的添加、复制、展开/折叠按钮被禁用
  • 拖拽排序、右键菜单、双击重命名等编辑操作被禁用
  • 底部状态栏显示运行时实体数量

点击运行时实体可以在 Inspector 中查看其组件数据。

Inspector 面板

在 Play Mode 下选中运行时实体后,Inspector 面板会:

  • 显示蓝色 RUNTIME 标记
  • 列出该实体的所有运行时组件及其当前属性值
  • 属性值定期自动刷新,反映游戏中的实时状态
  • 支持直接编辑数值、布尔值、字符串和向量属性,修改会立即发送到游戏实例中生效

退出 Play Mode

点击 Stop 按钮后:

  • 游戏实例被销毁
  • 场景从 Play 启动时的快照恢复
  • Hierarchy 面板恢复编辑模式的实体树,展开状态自动还原
  • Inspector 面板恢复到编辑模式
  • 所有运行时修改不会保存到场景文件

实时编辑

Play Mode 下可以在 Inspector 中编辑实体属性,修改会实时反映到游戏中。这对于调试速度、重力、UI 位置等参数非常实用。

可编辑的属性

属性类型可编辑
数值(int、float)
布尔值
字符串
向量(Vec2、Vec3)
颜色
枚举

还可以通过运行时 API 进行结构性操作:

  • 创建新实体
  • 销毁现有实体
  • 添加移除实体上的组件
  • 重命名重设父级

不可编辑的内容

  • Scene View Gizmo 在 Play 期间被禁用——不能通过拖拽 Gizmo 移动实体
  • 组件排序不可用
  • Prefab 编辑被禁用
  • 可见性开关在 Play 期间不生效

编辑工作流

典型的实时编辑工作流:

  1. Play — 启动预览
  2. 选择 Hierarchy 中的运行时实体
  3. 调整 Inspector 中的属性值(如速度、偏移量)
  4. 观察 Game View 中的实时效果
  5. 暂停 + 单步 逐帧检查行为
  6. Stop — 记下满意的数值
  7. 应用 在编辑模式下将数值写入场景

FPS 显示

预览运行时,工具栏右侧会实时显示当前帧率(FPS)。停止预览后 FPS 显示自动隐藏。

注意事项

  • Play Mode 下 Hierarchy 面板的编辑功能被禁用,包括拖拽排序、右键菜单和重命名
  • 运行时实体列表会定期更新,大量实体时可能存在短暂延迟
  • 分辨率切换在预览运行中也可以使用,画面会立即调整大小
  • 共享 Canvas 同一时间仅支持一个活跃的游戏相机