API / CLASS REFERENCE

UltralightSingleton

继承: Object

管理共享的 Ultralight 渲染器及远程 Inspector。

此单例由引擎注册，所有 View 共用。GDScript 使用 Engine.get_singleton("UltralightSingleton")，C# 使用 Engine.Singleton.GetSingleton("UltralightSingleton")。

逻辑更新已连接 SceneTree 的 process_frame，渲染已连接 RenderingServer 的 frame_pre_draw。普通应用无需手动推进循环。

方法

update_logic() → void

更新计时器并分发回调。默认每个 SceneTree process_frame 自动调用。通过 set_process 关闭自动逻辑更新后，宿主需定期调用此方法。

set_process(process: bool) → void

启用或关闭自动逻辑更新，不影响自动渲染连接。关闭后需自行调用 update_logic 推进计时器和回调。

start_remote_inspector_server(address: String, port: int) → bool

在 address 和 port 上启动远程 Inspector，返回是否成功。须在 Godot 主线程调用，使用匹配 SDK 的 mini-browser 连接。

内部生命周期回调

update_frame() → void

内部渲染回调，将活动页面绘制到 CPU Surface 或 GPU 目标。已自动连接 frame_pre_draw，应用无需手动调用。