SuperAPI AI 工具集

platform-web

编程与开发

查看项目

更新于 10-16 22:43

技能介绍

Platform: Web 是关于浏览器平台部署(HTML5 导出)的专家级蓝图,主要面向 Godot 引擎的 Web 导出场景。浏览器 API 集成、LocalStorage 持久化与包体尺寸优化构成了 Web 部署的核心内容。

一、用途 该蓝图用于指导将游戏项目部署到 Web/浏览器平台,覆盖渲染、加载体验、浏览器接口调用、数据持久化和构建体积控制等关键环节。

二、主要能力与内容

  1. 浏览器集成:提供 JavaScriptBridge 帮助方法,用于浏览器 API 集成,包括持久化与数据分析。可通过 OS.has_feature("web") 判断是否运行于浏览器,并使用 JavaScriptBridge.eval 执行浏览器端代码,例如输出日志。
  2. LocalStorage 存档:资料给出 save_to_browser() 与 load_from_browser() 的示例实现,通过 JSON.stringify / JSON.parse_string 与 localStorage.setItem / getItem 交互,并先判断是否处于 web 环境。
  3. 自定义加载界面:资料提供 index.html 自定义加载界面示例,包含进度条与状态文本;通过 engine.startGame 的 onProgress 回调计算百分比并更新进度条,加载完成后隐藏加载界面。
  4. 尺寸优化:通过渲染配置启用 ETC2/ASTC 纹理压缩(import_etc2_astc=true)、关闭 S3TC/BPTC(import_s3tc_bptc=false),并通过 exclude_filter 排除 .md、.txt、docs/* 等不必要文件。
  5. 性能目标:以中端浏览器 60 FPS 为目标;限制粒子(WebGL 上限较低)、减少绘制调用、避免大纹理。
  6. 最佳实践:加载界面提供反馈、文件大小控制在 50MB 以下、在手机上测试移动端 Web、HTTPS 要求。

三、可用脚本 资料列出 web_bridge_sync.gd:专家级 JavaScriptBridge 帮助方法,用于浏览器 API 集成(持久化、数据分析)。

四、Web 开发禁止事项

  1. 禁止使用 FileAccess 存档:浏览器沙箱会阻止文件系统访问,应使用 JavaScriptBridge + localStorage。
  2. 禁止忽略加载界面:默认加载界面下 20MB wasm 下载会导致用户关闭标签页,必须自定义 index.html,加入进度条与品牌素材。
  3. 禁止使用线程:Web 不支持 Thread.new(),应使用 await 进行异步,或用 await get_tree().process_frame 将工作拆分到多帧。
  4. 禁止忽视 HTTPS 要求:地理位置、麦克风、摄像头 API 需要 HTTPS;本地 http:// 会阻止这些 API,应使用 localhost 或 HTTPS。
  5. 禁止构建超过 50MB:100MB WebAssembly 会导致用户在加载时放弃;应压缩纹理(ETC2/ASTC)、排除未使用资源。
  6. 禁止硬编码窗口尺寸:在 Web 上设置 get_viewport().size = Vector2(1920, 1080) 会破坏移动浏览器;应使用 get_window().size_changed 与响应式 UI。

五、相关参考 资料注明“Related: export-builds, platform-mobile”。

六、限制与暂未提供内容 资料未提供具体价格、收费方式、支持平台清单、版本号、安装命令及官方文档链接;也未提供除上述脚本外的其他脚本信息,相关细节暂未提供。