SuperAPI AI 工具集

godot-platform-web

通用与其它

查看项目

更新于 10-15 22:10

技能介绍

用途:为 Godot 项目的 HTML5/Web 导出提供专家级规则与脚本集合,覆盖渲染、持久化、浏览器交互、托管与性能。

主要能力:提供多个可复用脚本,包括 web_local_storage_wrapper.gd(基于 get_interface + JSON 的配额安全 localStorage 存档)、web_javascript_bridge_callback.gd(create_callback 双向 JS↔GD 通信,需保持回调引用存活)、web_responsive_canvas_adaptor.gd(画布随视口缩放)、web_browser_input_guard.gd(屏蔽右键菜单与空格滚动默认行为)、web_resource_lazy_loader.gd(远程 PCK/资源拉取)、web_clipboard_interface.gd(Navigator 异步剪贴板)、web_visibility_auto_pause.gd(标签页隐藏时暂停引擎与音频)、web_navigation_guard.gd(beforeunload 未保存进度拦截)、web_external_url_opener.gd(noopener 打开外链)、web_performance_profiler.gd(向 JS 控制台输出 VRAM/绘制统计)。scripts/ 下另有 platform_web_patterns.gd、web_bridge_sync.gd、web_json_rpc_bridge.gd。

必要用法与规则:Web 导出必须使用 Compatibility(WebGL 2.0),不可用 Forward+;持久化不要用 FileAccess,改用 localStorage 封装,且不要用 JavaScriptBridge.eval 拼接 localStorage.setItem 字符串(注入/转义风险);启用线程/SharedArrayBuffer 需 COOP/COEP 跨源隔离;自定义 HTML 壳的 PCK/WASM 资源路径必须相对,以支持子目录托管;全屏/鼠标锁定须在用户手势内触发;标签页失焦时暂停音频。PWA 更新可通过 JavaScriptBridge.pwa_update_available 信号与 pwa_needs_update()/pwa_update() 处理。可用 OS.has_feature("web") 做特性门控。

适用场景:Godot 游戏或应用的浏览器发布、子目录托管、需要浏览器存档、剪贴板、外链、响应式画布与性能剖析的 Web 构建。

限制:WebGPU 不是 Godot 4.x 的 Web 渲染器;localStorage 不保证永久,生产环境应实现云存档回退;建议控制下载体积(约 50MB 内)并降低粒子/绘制调用/大纹理以维持约 60 FPS。具体价格、平台支持范围等资料未提供。