跳转至

显示、语言与音频总线

GFDisplaySettingsUtility 把通用设置应用到 Godot 的窗口、VSync、语言和音频总线层。它只处理常见引擎 API 边界,不定义项目设置页 UI、文案或业务分组。

var display := Gf.get_utility(GFDisplaySettingsUtility) as GFDisplaySettingsUtility

display.set_fullscreen(true)
display.set_vsync_mode(DisplayServer.VSYNC_ENABLED)
display.set_locale("zh_CN")
display.register_audio_bus_volume("Master", 1.0)
display.set_audio_bus_volume("Master", 0.75)

GFSettingsUtility 中的窗口模式被外部 UI 或配置流程改回窗口模式时,GFDisplaySettingsUtility 会同步应用已记录的窗口尺寸。离开窗口模式前会捕获最后一个有效窗口尺寸;如果应用在全屏模式启动且还没有持久化尺寸,则使用 default_windowed_size,未显式配置时再从项目 window override 或 viewport 尺寸推导,不会把当前全屏分辨率误记为窗口尺寸。

default_windowed_size 只解决“尚无 last-known-windowed 值”的初始化边界。全屏、无边框窗口、显示器切换和平台特定分辨率策略仍应由项目层决定。

显示设置是否允许某个分辨率、是否需要平台白名单、是否要同步到项目配置档,仍由项目层决定。