用途:面向 Web/浏览器平台(HTML5 导出)的部署指导,聚焦浏览器 API 集成、LocalStorage 持久化与构建体积优化。文中包含 web_bridge_sync.gd 脚本,提供 JavaScriptBridge 辅助,用于浏览器 API 集成(持久化、分析)。
主要能力与用法:通过 OS.has_feature("web") 判断是否运行在浏览器,并用 JavaScriptBridge.eval 执行浏览器端代码;存档使用 localStorage.setItem/getItem,配合 JSON.stringify 与 JSON.parse_string 读写数据,而非 FileAccess。自定义加载画面需在 index.html 中实现进度条与品牌元素,使用 engine.startGame 的 onProgress 回调更新进度并在完成后隐藏加载层。体积优化可关闭 S3TC/BPTC、启用 ETC2/ASTC 纹理压缩,并用 exclude_filter 排除文档等无用资源。
限制与禁止事项:Web 上不得用 FileAccess 存档(浏览器沙箱阻止文件系统);不得忽略加载画面(大体积 wasm 会使用户关闭标签页);不得使用 Thread.new()(Web 不支持),改用 await 或 await get_tree().process_frame 分帧处理;不得忽略 HTTPS 要求(定位、麦克风、摄像头 API 需 HTTPS,本地可用 localhost 或 HTTPS);构建体积不应超过 50MB;不得硬编码窗口尺寸,应使用 get_window().size_changed 与响应式 UI。性能目标为中等浏览器 60 FPS,需限制粒子、减少绘制调用、避免大纹理,并在手机端测试。相关主题:export-builds、platform-mobile。