Skip to content

Godot Web(实验性)

Godot HTML5 导出可通过 Autoload GDScript 桥 接入检视。扩展能检测 window.Engine / Godot canvas,但场景树、拾取、写属性、暂停依赖游戏侧手动添加桥接脚本。

对外商店文案仍以 Egret / Laya / Cocos / FairyGUI 为主;Godot 为实验性能力,需自行接入桥。

接入步骤

  1. 从扩展包复制桥接脚本:
    • 已安装扩展:chrome://extensions → 扩展详情 → 「加载的扩展程序」路径下 dist/godot/game_inspect_bridge.gd
    • 或源码仓库:packages/engine/godot/game_inspect_bridge.gd
  2. 放入 Godot 项目(建议 res://addons/h5_game_copilot/game_inspect_bridge.gd)。
  3. 项目 → 项目设置 → Autoload:添加该脚本,Node 名必须为 GameInspectBridge
  4. 导出 Web,用浏览器打开导出页。
  5. 按 F12 → H5 AI Inspector

无桥接时场景树会显示「等待 GameInspectBridge Autoload」占位说明。

已支持

能力说明
场景树周期快照同步(约 0.35s)
属性visible / position / size / rotation / scale / text / modulate 等;Vector2、Color 以对象形式展示
拾取Control + Sprite2D / Node2D 近似命中
高亮DOM 框(优先 global_rect)+ 选中时 CanvasItem modulate 闪烁
点击阻止DomPointerGuard 拦截 canvas 指针,检视拾取仍可用
暂停 / 下一帧SceneTree.paused(Autoload PROCESS_MODE_ALWAYS,暂停后仍可同步)

已知限制

  • __copilotSel快照 DTO,不是 Godot 活 Node;写值须走桥接 API,勿直接改 props 期望生效。
  • 3D 节点属性可读,拾取/高亮以 2D / Control 为主。
  • 骨骼资源导出、深度组件反射暂不支持。
  • 仅 Web 导出启用桥(OS.has_feature("web"))。

AI / 注入写值

javascript
var G = window.__H5_GAME_COPILOT_GODOT__;
var id = __copilotSel && __copilotSel.godotId;
if (G && id != null) {
  G.setProp(id, 'visible', false);
  G.setProp(id, 'position', { x: 100, y: 200 });
}

禁止套用 cc / egret / Laya API。

H5 Game AI Inspector