SuperAPI AI 工具集

bevy-platform-web

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:当同一个 Bevy 0.20 ECS 应用需要运行在浏览器中时使用本技能,用于配置 wasm32 canvas Window 与图形后端;打包流水线未在此说明。

主要能力:浏览器构建目标为 wasm32-unknown-unknown,需在 Cargo 中启用 webgl2 或 webgpu,二者互斥且只能启用一个。web、webgl2、webgpu 均为 Cargo feature,不是组件。http 与 https 用于远程资源下载(含安全提示),web_asset_cache 缓存下载且当前不失效条目。clipboard_image 在 WASM 上不受支持。

使用方式:把 canvas 指向 DOM id,开启 fit_canvas_to_parent 让画布跟随父元素,并设置 resolution。示例:bevy = { version = "0.20", features = ["webgl2"] };Window 中设置 canvas: Some("#bevy".into())、fit_canvas_to_parent: true、prevent_default_event_handling: true 与 resolution。运行中可重设 canvas 与逻辑分辨率。资源用相对路径加载(如 sprites/player.png),远程 http URL 需 http 或 https feature。

适用场景:需要在浏览器复用同一 ECS 应用时。限制:webgl2 与 webgpu 冲突不可同时启用;clipboard_image 在 wasm 不可用;远程资源缓存不过期。不得在未排序的两个系统中同时可变查询同一组件;不得在文档 URL 中固定 /0.20.0/;不得编造物理、导航、网络或 XR crate。

依赖前置技能:bevy-master、bevy-ecs-composition、bevy-platform-desktop。