SuperAPI AI 工具集

bevy-platform-mobile

通用与其它

查看项目

更新于 10-16 12:42

技能介绍

Bevy ECS 移动端技能,用于面向触屏设备开发时处理移动平台输入与窗口设置。目标为 Bevy 0.20+。

用途:在触摸设备上接入触控、捏合手势、屏幕边缘避让与移动端更新模式。打包、签名与商店权限弹窗不在范围内,XR 是独立主题。

主要能力与 ECS 形态:输入用 Touches 保存活动触点;PinchGesture 是 iOS 与 macOS 上双指捏合的消息类型。Android 需启用 android-game-activity 特性,android-native-activity 为旧式 activity。功耗方面 WinitSettings::mobile() 在聚焦时等待输入,失焦时降为每秒一次等待。iOS 边缘用 Window::preferred_screen_edges_deferring_system_gestures,取 ScreenEdge 值。纹理方面资源加载后 ASTC 在 Image 描述符中显示为 TextureFormat::Astc。

必要用法:Cargo 中声明 bevy = { version = "0.20", features = ["android-game-activity"] };主函数插入 WinitSettings::mobile()。摇杆区示例把首个触点转为单位轴,键盘鼠标留给 bevy-input-handling。捏合消息调整缩放资源。屏幕边缘示例将 primary window 的 preferred_screen_edges_deferring_system_gestures 设为 ScreenEdge::All,并统计资源库中已有 ASTC 图片。

限制:只使用官方有文档的 Bevy crate 与模块,不虚构物理、导航、网络或 XR crate,不在 Bevy 代码中混入 Godot 类型或 Godot 触摸屏/安全边距项目设置。同一组件的可变查询不得由两个未排序系统执行,需用 .chain() 排序或拆分。文档 URL 不锁定 /0.20.0/,版本目标在正文中说明一次。数据与时钟等状态归属见 Component、Resource、Query、Commands 及 Startup/Update/FixedMain 调度规则。