SuperAPI AI 工具集

bevy-adapt-mobile-to-desktop

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

该技能用于把一款以触摸优先的 Bevy 手机游戏适配到桌面端。根据文档描述,当触摸优先的游戏开始获得窗口、鼠标和键盘时,应加载本技能。窗口设置本身由 bevy-platform-desktop 负责。

主要能力与 ECS 结构

文档围绕 Bevy ECS 说明适配涉及的类型:

  • 窗口:Window、WindowMode、PrimaryWindow。
  • 输入:键盘、鼠标和手柄功能在 crate 页面中命名,并已由 bevy-input-handling 使用。
  • 指针:主窗口上的 CursorOptions,取值为 CursorGrabMode::None、Confined 或 Locked。

文档给出的桌面端选择表:屏幕按钮可用键盘和鼠标通过 bevy-input-handling 实现,并写入同一个意图组件;更宽的布局可在主 Window 上设置更宽的 WindowResolution;指针锁定可设置 CursorOptions.grab_mode = CursorGrabMode::Locked 并 visible = false。

使用方式

文档中的示例包括:

  • Cargo.toml 依赖示例,使用 bevy 0.20。
  • 打开 1920x1080 窗口视图,并在瞄准时锁定指针,涉及 WindowMode::Windowed、WindowResolution::new(1920, 1080)、PresentMode::AutoVsync、CursorGrabMode 等。
  • 解除帧率限制(PresentMode::AutoNoVsync)与无边框全屏(WindowMode::BorderlessFullscreen(MonitorSelection::Current))。
  • 用 WASD 替代屏幕摇杆,游戏系统读取 MoveIntent 而不是键码,示例中通过 ButtonInput<KeyCode> 写入 MoveIntent 组件。
  • F11 切换全屏,在 Windowed 与 Fullscreen 之间切换窗口模式。
  • 捕获视角使用当帧累计的鼠标运动量,示例通过 AccumulatedMouseMotion 与 LookRig 组件实现 apply_look 系统,并注册为 LookPlugin。

适用场景

适用于触摸优先的游戏新增窗口、鼠标与键盘支持的场景。文档专门说明:键盘和鼠标写入 MoveIntent 组件,触摸按钮可以继续写入同一个组件;窗口模式、分辨率、呈现模式和光标抓取都位于主窗口实体上。

限制与禁止事项

文档明确列出以下禁止事项:

  • 不要在文档 URL 中固定 /0.20.0/,理由是链接应停留在 latest,0.20 目标在正文中声明一次。
  • 不要从未排序的两个系统可变查询同一个组件,原因是调度会并行运行系统,除非用 .chain() 排序。
  • 不要在此处发明物理、导航、网络或 XR crate,原因是本技能只命名有文档的 Bevy crate 和模块。
  • 不要有绕过 MoveIntent 的第二条输入路径,原因是键盘、鼠标和触摸必须写入同一个组件,使 gameplay 保持设备无关。
  • 不要发明 API 或把未命名的第三方 crate 作为选定解法。

专家知识增量

目标为 Bevy 0.20+。核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。文档指出消息与观察者属于所有权槽位,其 API 参见 bevy-events-messaging;系统并行运行,除非用 .chain() 对冲突的系统排序。

文档提供所有权表:单个实体数据由 Component 拥有,可由一个系统通过 Query 修改,运行在 Update 或 FixedMain;整个应用的一个值由 Resource 拥有,由一个系统修改,Startup 插入后在读取它的调度中运行;生成由 Commands 承担;必须避免竞争的顺序由 .chain() 约束;插件边界由 Plugin 在 build 中注册系统与资源。并给出借用规则:两个系统若都可变查询同一个组件,必须排序(.chain())或拆分,使只有一个写入;无关系统保持并行。

决策表建议:按实体数据用 Component + Query,而不是把值存在实体外;应用级配置或时钟用 Resource,而不是复制到每个实体;稳定模拟步用 FixedMain 和 Fixed 时钟,而不是绑定原始帧 Update;启动生成用 Startup 中的 Commands,而不是从渲染系统生成;跨系统通知且非共享状态时使用消息或观察者槽位;文档集合之外的 API 应先查官方文档,而不是编造 crate 或 API。

参考

文档列出官方文档链接:Assets、Examples、Window examples、ECS、Plugins。相关技能包括前置技能 bevy-master、bevy-ecs-composition、bevy-platform-desktop、bevy-input-handling,互补技能 bevy-adapt-desktop-to-mobile(反向适配),暂无下游消费者。