【免费下载链接】amethystData-oriented and>项目地址https://gitcode.com/gh_mirrors/ame/amethyst点击查看免费下载System 在实例化时往往需要访问World中的资源例如为EventChannel注册ReaderId而 Amethyst 的默认World又对这些资源设有限制。SystemDescSystem Descriptor系统描述符trait 正是 Amethyst 用来描述如何实例化一个 System的标准机制它把初始化逻辑连同构造函数参数一起打包交给应用在构建调度器时执行。读完本文你将掌握SystemDesc的完整工作方式——包括SystemDescderive 自动生成实现所覆盖的五种典型场景、何时需要手动实现该 trait以及如何通过with_system_desc把带初始化逻辑的系统挂载到DispatcherBuilder上。为什么 System 初始化需要一套独立机制在 Amethyst 中System实例化时可能需要从World中获取资源。最常见的例子是获取某个EventChannel的ReaderId——系统需要先注册为事件的读者才能在run阶段读取事件。这里有一个关键约束见 system_initialization.md当World中已经存在某个事件通道时System 应该把自己注册为该通道的读者而不是替换它。直接替换会令该通道的所有其他读者失效破坏整个事件分发链路。与此同时应用启动时的World并不是空的它预置了一批默认资源——事件通道event channels、线程池thread pool、帧率限制器frame limiter等。正因为这些默认资源带有特殊的初始限制我们需要一种途径把 System 的初始化逻辑包括传给构造函数的参数完整地带到应用侧。这个初始化逻辑的载体就是SystemDesctrait。从调度层面看Amethyst 的System只负责描述可执行的逻辑真正的初始化发生在调度器构建阶段SystemBundle::load方法在Dispatcher构建时被惰性求值此时World与Resources已经可用适合初始化系统所需的实体或资源参见 dispatcher.rs。SystemDesc正是这段初始化逻辑的标准化入口。SystemDesc把如何构造 System描述出来SystemDesctrait 的核心是一个build方法它接收可变World引用并返回构造好的System实例impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { // 在这里读取/插入 World 资源然后构造 System SystemName::new(...) } }trait 带有两个生命周期参数a、b和一个系统类型参数SystemName分别对应World与DispatcherBuilder的生命周期以及目标 System 类型。build拿到mut World意味着它可以在实例化 System 前从World中读取fetch_mut/read_resource现有资源向World中插入insert缺失的资源用这些信息构造带状态的 System。对于每个 System都需要一个对应的SystemDesc实现来指明实例化逻辑。好在大多数 System 的初始化并不特殊此时可以直接在 System 类型上使用SystemDescderive让编译器自动生成实现# extern crate amethyst; use amethyst::ecs::{System, World}; struct SystemName; impl System for SystemName { fn run(mut self, data: Self::SystemData) { println!(Hello!); } }上述代码中struct SystemName没有任何构造参数也不需要访问World资源因此 derive 会自动生成一个无字段的SystemNameDesc及对应的SystemDesc实现build内部调用SystemName::default()。这正是 pong 教程第 3 篇中PaddleSystem的用法一个单元结构体加上SystemDescderive即可直接通过with添加进DispatcherBuilder。SystemDesc derive 支持的五种初始化场景如果初始化逻辑超出了直接default()的范畴SystemDescderive 依然能覆盖绝大多数常见需求。根据 system_desc_derive.mdderive 在生成实现时支持以下五类场景向 System 构造函数传递参数跳过部分字段由构造函数内部默认为EventChannel_在World中注册ReaderId为组件的FlaggedStorage注册ReaderId向World插入资源。下面逐一展开。场景一向构造函数传参当 System 的构造函数接收外部参数时derive 会生成一个同名加Desc后缀的构建器结构体字段与构造函数参数一一对应build方法把这些字段原样传给构造函数# extern crate amethyst; # use amethyst::ecs::System; pub struct SystemName { field_0: u32, field_1: String, } impl SystemName { fn new(field_0: u32, field_1: String) - Self { SystemName { field_0, field_1 } } }derive 自动生成的等价代码如下/// Builds a SystemName. #[derive(Default, Debug)] pub struct SystemNameDesc { field_0: u32, field_1: String, } impl SystemNameDesc { fn new(field_0: u32, field_1: String) - Self { SystemNameDesc { field_0, field_1 } } } impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { SystemName::new(self.field_0, self.field_1) } }注意这里的SystemNameDesc本身也带有#[derive(Default, Debug)]并且提供了new构造函数方便你以SystemNameDesc::new(...)或SystemNameDesc { field_0: ..., field_1: ... }的方式配置参数。场景二跳过字段交给构造函数默认如果部分字段由构造函数内部默认例如field_0固定为123derive 生成的SystemNameDesc只会保留构造函数实际需要的字段# extern crate amethyst; # use amethyst::ecs::System; # pub struct SystemName { field_0: u32, field_1: String, } impl SystemName { fn new(field_1: String) - Self { SystemName { field_0: 123, field_1, } } }生成的实现只携带field_1/// Builds a SystemName. #[derive(Default, Debug)] pub struct SystemNameDesc { field_1: String, } impl SystemNameDesc { fn new(field_1: String) - Self { SystemNameDesc { field_1 } } } impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { SystemName::new(self.field_1) } }无字段参数的特例如果 System 没有任何字段参数例如#[derive(Default)] pub struct SystemName { field_0: u32 }则生成的SystemDesc实现会直接调用SystemName::default()/// Builds a SystemName. #[derive(Debug)] pub struct SystemNameDesc {} impl Default for SystemNameDesc { fn default() - Self { SystemNameDesc {} } } impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { SystemName::default() } }场景三为 EventChannel 注册 ReaderId当 System 需要消费World中既有EventChannel的事件时derive 会识别出构造函数参数中的ReaderIdT字段并在build中通过fetch_mut获取该通道后调用register_reader()注册一个新读者——而不是替换通道本身从而保证其他读者的ReaderId继续有效# extern crate amethyst; # use amethyst::{ # ecs::System, # shrev::{EventChannel, ReaderId}, # ui::UiEvent, # }; # pub struct SystemName { reader_id: ReaderIdUiEvent, } impl SystemName { fn new(reader_id: ReaderIdUiEvent) - Self { SystemName { reader_id } } }生成的实现如下impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { let reader_id world.fetch_mut::EventChannelUiEvent().register_reader(); SystemName::new(reader_id) } }以UiEvent为例UiEvent由amethyst_ui提供见 ui/event.rs这条链路意味着UI 系统在初始化时自动订阅 UI 事件通道之后在run阶段即可通过reader_id逐个读取事件。场景四为组件 FlaggedStorage 注册 ReaderId除了事件通道组件存储WriteStorage背后的FlaggedStorage也会产生ComponentEvent。当 System 需要监听特定组件的增删改事件时同样可以用ReaderIdComponentEvent作为构造参数derive 会自动从对应组件存储上注册读者# extern crate amethyst; # use amethyst::{ # ecs::System, # shrev::{EventChannel, ReaderId}, # ui::UiResize, # }; # pub struct SystemName { resize_events_id: ReaderIdComponentEvent, } impl SystemName { fn new(resize_events_id: ReaderIdComponentEvent) - Self { SystemName { resize_events_id } } }生成的实现通过WriteStorage::UiResize::fetch(world).register_reader()完成注册impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { let resize_events_id WriteStorage::UiResize::fetch(world).register_reader(); SystemName::new(resize_events_id) } }这一模式非常适合组件被修改后需要同步刷新的系统把ComponentEvent的ReaderId作为 System 的字段在run中通过events(storage)接口消费变更事件。场景五向 World 插入资源某些 System 依赖的资源并不存在于初始World中需要先插入。derive 通过#[system_desc(insert(...))]属性或推导出的插入需求在build中把资源写入World然后才构造 System# extern crate amethyst; # use amethyst::ecs::System; # pub struct NonDefault; #[derive(Default)] pub struct SystemName; impl System for SystemName { type SystemData ReadExpecta, NonDefault; fn build(self) - Box(dyn ParallelRunnable static) {} }生成的实现先world.insert(NonDefault)再返回SystemName::default()impla, b ::amethyst::core::SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut ::amethyst::ecs::World) - SystemName { world.insert(NonDefault); SystemName::default() } }这样System 在运行时通过ReadExpectNonDefault读取资源时可以确信该资源已由初始化逻辑保证存在。Amethyst 自身的测试也验证了这一属性在 amethyst_application.rs 中SystemNonDefault使用#[derive(Debug, SystemDesc)]加#[system_desc(insert(ApplicationResourceNonDefault))]注入一个非 Default 资源系统再以ReadExpects, ApplicationResourceNonDefault读取。手动实现 SystemDesc当 derive 不够用时SystemDescderive 覆盖的场景是有限的。如果你的初始化逻辑包含更复杂的世界操作例如同时插入资源并克隆数据、构造依赖其他资源的内部状态、或者需要泛型参数可以手动实现该 trait。手册在 implementing_the_system_desc_trait.md 中给出了音频系统的完整例子——AudioSystem需要持有音频Output并同时把该Output克隆一份插入World供其他系统共享# extern crate amethyst; use amethyst::{ audio::output::Output, ecs::{System, World}, }; /// Syncs 3D transform data with the audio engine to provide 3D audio. #[derive(Debug, Default)] pub struct AudioSystem(Output); impl System for AudioSystem { fn build(mut self) - Boxdyn ParallelRunnable {} } /// Builds an AudioSystem. #[derive(Default, Debug)] pub struct AudioSystemDesc { /// Audio Output. pub output: Output, } impl SystemDesca, b, AudioSystem for AudioSystemDesc { fn build(self, world: mut World) - AudioSystem { world.insert(self.output.clone()); AudioSystem(self.output) } } // in main.rs: // let game_data DispatcherBuilder::default() // .with_system_desc(AudioSystemDesc::default(), , []);这个例子展示了手动实现与 derive 的本质区别build方法内的逻辑完全由你掌控——先world.insert(self.output.clone())让Output成为全局资源再把原始output移入AudioSystem作为系统私有状态。手写模板无类型参数日常手写时可以套用下面的通用模板只替换SystemName、参数来源和构造调用# extern crate amethyst; /// Builds a SystemName. #[derive(Default, Debug)] pub struct SystemNameDesc; impl SystemDesca, b, SystemName for SystemNameDesc { fn build(self, world: mut World) - SystemName { let arg unimplemented!(Replace code here); SystemName::new(arg) } }手写模板带类型参数如果 System 带泛型参数例如SystemNameT描述符也需要泛型化。此时用PhantomDataT标记类型并配合derivative的Default(bound )以解除默认实现的 trait 约束# extern crate amethyst; # extern crate derivative; use std::marker::PhantomData; use derivative::Derivative; /// Builds a SystemName. #[derive(Derivative, Debug)] #[derivative(Default(bound ))] pub struct SystemNameDescT { marker: PhantomDataT, } impl SystemDesca, b, SystemNameT for SystemNameDescT where T: unimplemented!(Replace me.), { fn build(self, world: mut World) - SystemNameT { let arg unimplemented!(Replace code here); SystemName::new(arg) } }#[derivative(Default(bound ))]允许SystemNameDescT在任何T下实现Default避免泛型参数无谓地进入默认值约束。把带初始化逻辑的系统挂载到调度器SystemDesc的最终归宿是调度器。在Application测试辅助 API 中with_system_desc方法接收一个SystemDesc实现、一个系统名和一组依赖名将描述符封装为SystemDescInjectionBundle注册进GameData见 amethyst_application.rspub fn with_system_descSD, S, N(self, system_desc: SD, name: N, deps: [N]) - Self where SD: SystemDescstatic, static, S Send Sync static, S: forsys_local Systemsys_local Send static, N: IntoString Clone,从调用链看system_desc_injection_bundle.rsSystemDescInjectionBundle实现SystemBundle时会在build阶段调用self.system_desc.build(world)得到 System 实例再连同system_name与system_dependencies一起通过builder.add(...)注册builder.add( self.system_desc.build(world), self.system_name, system_dependencies, ... );这解释了为什么build能在world上做插入/读取操作它发生在Dispatcher构建、资源就绪之后、系统真正运行之前。仓库实战PrefabLoaderSystemDesc最典型的内置用法是资产加载系统的描述符。在 custom_ui 示例 中PrefabLoaderSystemDesc::MyPrefabData::default()被直接挂载let mut game_data DispatcherBuilder::default() .with_system_desc(PrefabLoaderSystemDesc::MyPrefabData::default(), , []) .add_bundle(TransformBundle::new())? .add_bundle(InputBundle::new())? .add_bundle(UiBundle::StringBindings, CustomUi::new())? ...PrefabLoaderSystemDesc带泛型参数MyPrefabData因此以::MyPrefabData::default()形式实例化。同样的模式还出现在 renderable_custom 示例 中——那里同时挂载了PrefabLoaderSystemDesc与UiGlyphsSystemDesc::DefaultBackend::default()后者负责初始化UiGlyphsSystem维护GlyphBrush、字形实体缓存与字体映射等渲染状态参见 glyphs.rs是必须通过描述符初始化复杂内部状态的又一例证。从迁移文档specs_migration.md还可以看到这类描述符的普遍性PrefabLoaderSystem由PrefabLoaderSystemDesc初始化、GltfSceneLoaderSystem由GltfSceneLoaderSystemDesc初始化均以::T::default()形式构造——这与本文场景一/二的机制完全一致。实践要点与决策建议结合上述内容在实际开发中可以遵循以下决策路径System 不需要任何初始化逻辑直接#[derive(SystemDesc)]或仅实现Systemtrait通过with添加。需要传入配置参数、注册事件读者或插入资源优先使用#[derive(SystemDesc)]让 derive 依据 System 的字段与构造函数自动生成对应逻辑注意保持构造函数参数类型与字段类型一致derive 正是靠类型推断来识别ReaderIdT与跳过字段的。初始化涉及复杂控制流、泛型约束或多次 World 操作手动实现SystemDesctrait参考 音频系统示例并在DispatcherBuilder上改用with_system_desc注册。绝对不要替换World中已有的EventChannel使用register_reader()追加读者避免使其他系统持有的ReaderId失效。SystemDesc是 Amethyst 中连接系统声明与系统实例化的桥梁它把对World的依赖声明式地写进类型系统让调度器构建阶段可以安全、可预测地完成资源装配。理解它的五个 derive 场景与手动实现路径就能在编写自定义系统时从容处理构造函数参数、事件订阅与资源注入这三类最常见的初始化需求。赞分享【免费下载链接】amethystData-oriented and>项目地址https://gitcode.com/gh_mirrors/ame/amethyst点击查看免费下载相关推荐终极指南如何在Linux上免费获得专业级音频插件终极指南如何在Linux上免费获得专业级音频插件 你是否曾经在Linux上进行音乐制作或音频处理时发现缺乏高质量的音频插件或者你正在寻找一个完全免费、开源MXNet初始化系统全局状态管理与资源初始化流程MXNet初始化系统全局状态管理与资源初始化流程 在深度学习框架的使用过程中你是否曾遇到过因环境配置不当导致的初始化失败或者在多进程训练时出现资源竞争的问深度学习人工智能机器学习分布式训练你的私人AI秘书用Buzz实现完全离线的语音转文字革命你的私人AI秘书用Buzz实现完全离线的语音转文字革命 在数字时代你是否厌倦了将敏感录音上传到云端服务器 Buzz 是一款基于OpenAI Whisper人工智能语音音频本地部署桌面应用上一篇如何快速掌握AgentScope面向新手的智能体开发完整指南下一篇go-json兼容 encoding/json 的高性能 Go JSON 编解码库——原理剖析与 Tempo 仓库中的 vendoring 实证创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考