Appearance
Godot Web(实验性)
Godot HTML5 导出可通过 Autoload GDScript 桥 接入检视。扩展能检测 window.Engine / Godot canvas,但场景树、拾取、写属性、暂停依赖游戏侧手动添加桥接脚本。
对外商店文案仍以 Egret / Laya / Cocos / FairyGUI 为主;Godot 为实验性能力,需自行接入桥。
接入步骤
- 从扩展包复制桥接脚本:
- 已安装扩展:
chrome://extensions→ 扩展详情 → 「加载的扩展程序」路径下dist/godot/game_inspect_bridge.gd - 或源码仓库:
packages/engine/godot/game_inspect_bridge.gd
- 已安装扩展:
- 放入 Godot 项目(建议
res://addons/h5_game_copilot/game_inspect_bridge.gd)。 - 项目 → 项目设置 → Autoload:添加该脚本,Node 名必须为
GameInspectBridge。 - 导出 Web,用浏览器打开导出页。
- 按 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。