【免費下載鏈接】amethystData-oriented and>項目地址https://gitcode.com/gh_mirrors/ame/amethyst點擊查看免費下載本文是 AmethystRust 數據驅動游戲引擎Pong 教程系列的第四篇基于倉庫中 book/src/pong-tutorial/pong-tutorial-04.md 編寫。在第三篇我們已經實現了捕捉鍵盤輸入驅動擋板移動的PaddleSystem本篇將在既有 ECS 架構之上為游戲加入一個全新的實體——球Ball先為其定義Ball組件并在世界中心生成實體再編寫MoveBallsSystem基于 delta time 的幀率無關移動與BounceSystem球與擋板、上下邊界的碰撞反彈最后通過狀態(tài)SimpleState中的字段與update方法實現球的延遲生成解決游戲剛啟動球就立刻飛離屏幕的問題。讀完本篇你將掌握如何定義并注冊自定義組件、如何用Time資源實現幀率無關的運動、如何用包圍盒展開法做軸對齊碰撞檢測以及如何用Optionf32計時器實現延遲生成邏輯。完整代碼見倉庫 examples/pong_tutorial_04 示例。前置準備本教程對應的運行方式本教程的所有階段性代碼都作為獨立示例存放在倉庫 examples 目錄下pong_tutorial_01至pong_tutorial_06分別對應教程每一步完成后的狀態(tài)。如果你克隆了 Amethyst 倉庫可以直接運行本篇對應的示例cargo run -p pong_tutorial_04運行前需要先完成 Getting started 章節(jié) 的環(huán)境準備。示例運行所需的資產精靈圖與配置display.ron、bindings.ron都位于 examples/pong_tutorial_04 目錄中。注意倉庫內示例的main.rs有一行注釋說明由于示例運行在 git 倉庫上下文里資產目錄使用了app_root.join(assets/)這一與教程正文略有不同的加載方式見 examples/pong_tutorial_04/main.rs。定義球的常量與 Ball 組件在 pong.rs 中新增常量與之前章節(jié)一樣先在 pong.rs 頂部定義本章需要的常量。教程采用硬編碼常量而非外部配置文件的方式注釋中也說明了原因當需要頻繁調整數值時配置文件更有優(yōu)勢這里為了保持簡單直接寫在代碼里pub const BALL_VELOCITY_X: f32 75.0; pub const BALL_VELOCITY_Y: f32 50.0; pub const BALL_RADIUS: f32 2.0;結合倉庫中完整的 pong.rs 可以看到它們與之前定義的競技場與擋板常量并列pub const ARENA_HEIGHT: f32 100.0; pub const ARENA_WIDTH: f32 100.0; pub const PADDLE_HEIGHT: f32 16.0; pub const PADDLE_WIDTH: f32 4.0;其中ARENA_WIDTH與ARENA_HEIGHT均為 100.0球的初速度在 X 方向為 75.0、Y 方向為 50.0每秒移動的單位數半徑僅 2.0——這些數值共同決定了球在競技場中的運動節(jié)奏。創(chuàng)建 Ball 組件接下來定義Ball組件。在 ECS 中組件就是純數據球需要速度與半徑所以組件就保存這兩項pub struct Ball { pub velocity: [f32; 2], pub radius: f32, }倉庫中的實際定義位于 examples/pong_tutorial_04/pong.rs。注意這里velocity用[f32; 2]數組分別表示 x、y 兩個方向的速度反彈邏輯將通過取負號翻轉某個方向的分量來實現。與之對比擋板組件Paddlepong.rs則保存side、width、height以及位置x、y碰撞檢測時會用到擋板的寬高與陣營Side::Left/Side::Right。編寫 initialize_ball 生成函數參照上一篇initialize_paddles的寫法新增initialize_ball函數在競技場中央生成一個球實體/// initializes one ball in the middle-ish of the arena. fn initialize_ball(world: mut World, sprite_sheet_handle: HandleSpriteSheet) { // Create the translation. let mut local_transform Transform::default(); local_transform.set_translation_xyz(ARENA_WIDTH / 2.0, ARENA_HEIGHT / 2.0, 0.0); // Assign the sprite for the ball. The ball is the second sprite in the sheet. let sprite_render SpriteRender::new(sprite_sheet_handle, 1); world .push((sprite_render),Ball { radius: BALL_RADIUS, velocity: [BALL_VELOCITY_X, BALL_VELOCITY_Y], },local_transform); }幾個關鍵點初始位置球的Transform被設置為(ARENA_WIDTH / 2.0, ARENA_HEIGHT / 2.0, 0.0)即競技場中心倉庫最終版做了微調改為(ARENA_WIDTH - BALL_RADIUS) * 0.5與(ARENA_HEIGHT - BALL_RADIUS) * 0.5見 pong.rs效果上都是居中生成。精靈索引SpriteRender::new(sprite_sheet_handle, 1)中的1表示使用精靈圖中的第二個精靈。上一章繪制擋板我們學過如何加載精靈圖精靈圖布局定義在 assets/texture/pong_spritesheet.ron紋理尺寸為 8×16第一個精靈索引 0是x: 0, y: 0, width: 4, height: 16的豎長條擋板第二個精靈索引 1是x: 4, y: 0, width: 4, height: 4的正方形球。實體組裝通過world.push(...)一次把渲染組件、邏輯組件與變換組件組合成實體——這正是 ECS 的核心用法實體只是把數據組件聚合在一起的邏輯容器。在 on_start 中注冊并生成球要確保代碼按預期工作需要更新on_start方法。這一步要臨時注冊Ball組件并調用initialize_ballfn on_start(mut self, data: StateData_, GameData) { let world data.world; // Load the spritesheet necessary to render the graphics. let sprite_sheet_handle load_sprite_sheet(world); world.register::Ball(); // - add this line temporarily initialize_ball(world, sprite_sheet_handle.clone()); // - add this line initialize_paddles(world, sprite_sheet_handle); initialize_camera(world); }這里有兩個容易踩坑的細節(jié)register::Ball()是臨時的教程強調這一行只是暫時添加。因為在 ECS 中World需要預先知道組件類型才能為其分配存儲空間當稍后引入MoveBallsSystem、BounceSystem等系統(tǒng)后系統(tǒng)本身會負責注冊所需的組件屆時這一行就需要移除倉庫最終版 pong.rs 的on_start中已經沒有它了。sprite_sheet_handle.clone()必不可少initialize_paddles和initialize_ball都會消費consume這個句柄Handle按值傳遞所以第二次調用前必須克隆一份否則所有權會被轉移、編譯無法通過。Handle本身是引用計數的輕量句柄克隆成本極低。此時運行游戲應該能看到兩塊擋板和位于屏幕中央的球。用 MoveBallsSystem 讓球動起來delta time 與幀率無關System 的本質上一篇教程介紹過System 是對某一類組件全體實體行為的描述而非單個實例。它每幀運行一次讀取Ball與Transform組件并更新變換。我們新建systems/move_balls.rs實現MoveBallsSystemuse amethyst::{ core::timing::Time, core::transform::Transform, ecs::{System, World}, }; use crate::pong::Ball; pub struct MoveBallsSystem; impl System for MoveBallsSystem { type SystemData ( .read_component::Ball(), .write_component::Transform() .read_resource::Time(), ); fn run(mut self, (balls, mut locals, time): Self::SystemData) { // Move every ball according to its speed, and the time passed. for (ball, local) in (balls, mut locals).join() { local.prepend_translation_x(ball.velocity[0] * time.delta_seconds()); local.prepend_translation_y(ball.velocity[1] * time.delta_seconds()); } } fn build(self) - Box(dyn ParallelRunnable static) {} }注教程正文的片段沿用了舊版 Specs 的SystemData/join()寫法倉庫中的實際示例已升級為基于SystemBuilder的新 API見下文與倉庫實現對照。這個系統(tǒng)做的事遍歷所有同時擁有Ball和Transform的實體將速度分量乘以delta_seconds后累加到平移上。join()是 ECS 中經典的聯(lián)接操作——它同時遍歷多個組件存儲只產出那些同時持有全部所需組件的實體。當前游戲只有一個球但如果未來出現多個球這個系統(tǒng)無需任何修改即可天然支持所有球實體——這正是 ECS 數據驅動范式的優(yōu)勢。幀率無關運動為什么需要 delta time教程特別強調幀率無關framerate independence無論游戲跑在 60 FPS 還是 144 FPS 的機器上球都應保持相同的移動速度。如果簡單地在每幀加上固定位移高幀率機器的球就會飛得更快物理節(jié)奏完全失真。解決辦法就是delta time增量時間即自上一幀以來經過的時長這一技巧通常被稱為 delta timing。在 Amethyst 中可以通過資源amethyst::core::timing::Time文檔見 amethyst_core::timing::Time獲取其delta_seconds()方法返回自上一幀以來的秒數。Time是一個資源Resource——與組件不同資源是全局共享的單例數據由引擎每幀自動更新因此系統(tǒng)只需通過.read_resource::Time()聲明讀取即可。local.prepend_translation_x(ball.velocity[0] * time.delta_seconds());位移 速度 × 時間這是經典的物理運動公式。無論幀率高低每幀走過的路程都與該幀實際耗時成正比從而保證全局速度一致。與倉庫實現對照SystemBuilder 新 API倉庫 examples/pong_tutorial_04/systems/move_balls.rs 中給出了教程片段的現代化版本邏輯完全一致只是換用了SystemBuilderimpl System for BallSystem { fn build(self) - Boxdyn ParallelRunnable { Box::new( SystemBuilder::new(MoveBallsSystem) .with_query((Ball, mut Transform)::query()) .read_resource::Time() .read_component::Ball() .write_component::Transform() .build(move |_commands, world, time, query_balls| { for (ball, local) in query_balls.iter_mut(world) { local.prepend_translation_x( ball.velocity[0] * time.delta_time().as_secs_f32(), ); local.prepend_translation_y( ball.velocity[1] * time.delta_time().as_secs_f32(), ); } }), ) } }with_query聲明查詢(Ball, mut Transform)組合read_resource::Time()聲明讀取Time資源delta_time().as_secs_f32()與舊 API 的delta_seconds()等價。無論哪種寫法核心思想一致讀速度、讀時間、寫變換三者結合實現幀率無關移動。用 BounceSystem 實現碰撞反彈球能動之后還需要檢測碰撞并反彈。新建systems/bounce.rs實現BounceSystem職責有二球與上下邊界的碰撞、球與兩塊擋板的碰撞。碰撞發(fā)生時通過翻轉Ball組件速度在 x 或 y 軸上的分量實現反彈。use amethyst::{ core::{Transform}, ecs::{System, World}, }; use crate::pong::{Ball, Paddle, Side, ARENA_HEIGHT}; pub struct BounceSystem; impl System for BounceSystem { type SystemData ( .write_component::Ball() .read_component::Paddle(), .read_component::Transform(), ); fn run(mut self, (mut balls, paddles, transforms): Self::SystemData) { // Check whether a ball collided, and bounce off accordingly. // // We also check for the velocity of the ball every time, to prevent multiple collisions // from occurring. for (ball, transform) in (mut balls, transforms).join() { let ball_x transform.translation().x; let ball_y transform.translation().y; // Bounce at the top or the bottom of the arena. if (ball_y ball.radius ball.velocity[1] 0.0) || (ball_y ARENA_HEIGHT - ball.radius ball.velocity[1] 0.0) { ball.velocity[1] -ball.velocity[1]; } // Bounce at the paddles. for (paddle, paddle_transform) in (paddles, transforms).join() { let paddle_x paddle_transform.translation().x - (paddle.width * 0.5); let paddle_y paddle_transform.translation().y - (paddle.height * 0.5); // To determine whether the ball has collided with a paddle, we create a larger // rectangle around the current one, by subtracting the ball radius from the // lowest coordinates, and adding the ball radius to the highest ones. The ball // is then within the paddle if its center is within the larger wrapper // rectangle. if point_in_rect( ball_x, ball_y, paddle_x - ball.radius, paddle_y - ball.radius, paddle_x paddle.width ball.radius, paddle_y paddle.height ball.radius, ) { if (paddle.side Side::Left ball.velocity[0] 0.0) || (paddle.side Side::Right ball.velocity[0] 0.0) { ball.velocity[0] -ball.velocity[0]; } } } } } fn build(self) - Box(dyn ParallelRunnable static) {} } // A point is in a box when its coordinates are smaller or equal than the top // right and larger or equal than the bottom left. fn point_in_rect(x: f32, y: f32, left: f32, bottom: f32, right: f32, top: f32) - bool { x left x right y bottom y top }上下邊界反彈if (ball_y ball.radius ball.velocity[1] 0.0) || (ball_y ARENA_HEIGHT - ball.radius ball.velocity[1] 0.0) { ball.velocity[1] -ball.velocity[1]; }球的 y 坐標小于等于其半徑時觸底大于等于ARENA_HEIGHT - ball.radius時觸頂兩種情況都翻轉velocity[1]。注意這里同時檢查速度方向 0.0或 0.0這可以防止重復碰撞——如果球已經反彈向上那么即使下一幀坐標仍在邊界附近由于速度方向已正確也不會再次觸發(fā)翻轉避免球卡在邊界上來回抖動。擋板碰撞把球當膨脹的矩形檢測擋板碰撞檢測的思路值得細講。判斷球圓心(ball_x, ball_y)、半徑ball.radius是否碰到矩形擋板左下角(paddle_x, paddle_y)、寬paddle.width、高paddle.height等價于判斷圓心是否落在一個膨脹過的矩形內把擋板的四條邊分別向外擴ball.radius得到更大的包圍矩形paddle_x - ball.radius, // left 左邊界外擴 paddle_y - ball.radius, // bottom 下邊界外擴 paddle_x paddle.width ball.radius, // right 右邊界外擴 paddle_y paddle.height ball.radius, // top 上邊界外擴然后調用工具函數point_in_rect判斷圓心是否落入該膨脹矩形fn point_in_rect(x: f32, y: f32, left: f32, bottom: f32, right: f32, top: f32) - bool { x left x right y bottom y top }只要 x 在[left, right]、y 在[bottom, top]閉區(qū)間內即為碰撞。這就是將圓-矩形碰撞等價轉化為點-矩形包含測試的經典做法把復雜的幾何相交問題化簡為幾次浮點比較。下圖直觀展示了這一判定邏輯反彈時同樣校驗速度方向確保只有球真正朝向擋板飛來時才翻轉 x 方向速度if (paddle.side Side::Left ball.velocity[0] 0.0) || (paddle.side Side::Right ball.velocity[0] 0.0) { ball.velocity[0] -ball.velocity[0]; }左擋板只反彈向左飛velocity[0] 0.0的球右擋板只反彈向右飛velocity[0] 0.0的球防止球粘在擋板上被反復翻轉。倉庫最終版 systems/bounce.rs 在邏輯上完全一致?lián)醢逦恢酶挠蒔addle組件自身的x、y字段提供碰撞時打印Bounce!便于調試并使用了world.split_for_query將球查詢與擋板查詢分區(qū)以避免借用沖突——這是同一碰撞邏輯在新 API 下的表達。注冊新系統(tǒng)systems/mod.rs 與 Dispatcher更新 systems/mod.rs教程正文給出的模塊組織方式是在systems/mod.rs中同時使用pub use重導出與mod聲明pub use self::paddle::PaddleSystem; pub use self::move_balls::MoveBallsSystem; pub use self::bounce::BounceSystem; mod move_balls; mod bounce; mod paddle;倉庫中的 systems/mod.rs 則采用更直接的pub mod寫法pub mod bounce; pub mod move_balls; pub mod paddle;無論哪種組織方式目標都是把各個系統(tǒng)作為模塊暴露出去供main.rs統(tǒng)一組裝。把系統(tǒng)加入 Dispatcher最后一步是把新系統(tǒng)注冊進調度器DispatcherAmethyst 用它管理系統(tǒng)的執(zhí)行順序與并行性let game_data DispatcherBuilder::default() // ...other systems... .with(systems::MoveBallsSystem, ball_system, []) .with( systems::BounceSystem, collision_system, [paddle_system, ball_system], );這里體現了 Amethyst 系統(tǒng)依賴聲明機制MoveBallsSystem命名為ball_system依賴列表為空[]表示它不依賴其他系統(tǒng)BounceSystem命名為collision_system依賴[paddle_system, ball_system]表示碰撞檢測必須在擋板移動和球移動之后執(zhí)行——順序非常重要先移動再檢測碰撞并反彈否則會出現穿透或延遲反彈的錯誤觀感。倉庫最終版 main.rs 通過add_system按序添加了PaddleSystem、BallSystem、BounceSystem并依次掛載了LoaderBundle資產加載、TransformBundle變換跟蹤、InputBundle輸入與RenderingBundle渲染等 bundle。運行到這里球已經會移動并在擋板與上下邊界間反彈。但很快會發(fā)現一個問題球從左右兩側飛出屏幕后就再也回不來了游戲直接結束——而且由于初始速度很快可能窗口剛彈出球就已經在屏幕外了。甚至需要把BALL_VELOCITY_X調得極小才能觀察到這個過程。這顯然不是真正的游戲應有的表現下一節(jié)解決它。延遲生成球用狀態(tài)字段與 update 計時問題與思路球在游戲啟動瞬間就生成并立刻飛離屏幕這會造成兩個問題體驗問題玩家可能還沒來得及看清局面就已經丟分技術問題操作系統(tǒng)與渲染器需要時間初始化窗口球過早生成可能出現在不可見或未就緒的渲染狀態(tài)下。教程明確指出正規(guī)游戲通常會有獨立的菜單狀態(tài)來過渡我們的 Pong 直接進入對局所以必須自行處理。解決方案是讓球延遲生成——這也是一個練習用游戲狀態(tài)State結構體持有數據的好機會。新增 update 方法SimpleState提供了多個生命周期方法之前用過on_start狀態(tài)啟動時調用一次?，F在在on_start正下方新增update方法——它每幀都會執(zhí)行返回值SimpleTrans用于表示狀態(tài)轉換impl SimpleState for MyState { fn update(mut self, data: mut StateData_, GameData) - SimpleTrans { Trans::None } }這里我們不需要切換狀態(tài)因此返回Trans::None。update每幀執(zhí)行這一特性正好用來倒計時每幀從計時器中減去 delta time歸零時再生成球。給 Pong 狀態(tài)添加字段由于update需要訪問球精靈句柄而它目前是on_start內的局部變量必須提升為狀態(tài)字段同時需要一個計時器字段。教程的做法是用兩個Option#[derive(Default)] pub struct Pong { ball_spawn_timer: Optionf32, sprite_sheet_handle: OptionHandleSpriteSheet, }設計要點ball_spawn_timer: Optionf32計時器。Some表示倒計時未結束每幀減 delta time減到 0.0時生成球并置為None之后不再生成。用Option表達是否還需要生成球這一狀態(tài)天然避免重復生成。sprite_sheet_handle: OptionHandleSpriteSheet精靈句柄。無法在Pong的構造器里創(chuàng)建需要World與資源只能在on_start中加載后存入。#[derive(Default)]自動實現Defaulttrait讓我們能寫出Pong::default()得到空狀態(tài)。在 main.rs 使用默認狀態(tài)Application::new需要傳入初始狀態(tài)改用Pong::default()即可let mut game Application::new(assets_dir, Pong::default(), game_data)?;倉庫 main.rs 正是這樣寫的。完成計時與生成邏輯最后重寫on_start與update完成延遲生成impl SimpleState for Pong { fn on_start(mut self, data: StateData_, GameData) { let world data.world; // Wait one second before spawning the ball. self.ball_spawn_timer.replace(1.0); // Load the spritesheet necessary to render the graphics. // spritesheet is the layout of the sprites on the image; // texture is the pixel data. self.sprite_sheet_handle.replace(load_sprite_sheet(world)); initialize_paddles(world, self.sprite_sheet_handle.clone().unwrap()); initialize_camera(world); } fn update(mut self, data: mut StateData_, GameData) - SimpleTrans { if let Some(mut timer) self.ball_spawn_timer.take() { // If the timer isnt expired yet, subtract the time that passed since the last update. { let time data.world.fetch::Time(); timer - time.delta_seconds(); } if timer 0.0 { // When timer expire, spawn the ball initialize_ball(data.world, self.sprite_sheet_handle.clone().unwrap()); } else { // If timer is not expired yet, put it back onto the state. self.ball_spawn_timer.replace(timer); } } Trans::None } }逐步拆解這段邏輯on_start中self.ball_spawn_timer.replace(1.0)把計時器初始化為 1 秒加載精靈圖并存入狀態(tài)字段隨后照常生成擋板與相機——注意initialize_ball已從on_start中移除球的生成完全交給update控制。update中用self.ball_spawn_timer.take()取出計時器同時把字段置為None。如果它是Some先通過data.world.fetch::Time()獲取Time資源減去delta_seconds()若減后timer 0.0說明延遲時間已到調用initialize_ball(data.world, self.sprite_sheet_handle.clone().unwrap())生成球否則把剩余時間寫回self.ball_spawn_timer.replace(timer)等待下一幀繼續(xù)倒計時。take()replace()的巧思take()確保計時器每幀只被處理一次避免重復扣減未到期時replace寫回到期后保持Noneif let分支不再進入球只生成一次。倉庫最終版 pong.rs 與此完全對應只是資源訪問方式略有差異data.resources.get::Time().unwrap()與delta_time().as_secs_f32()延遲同樣設為 1.0 秒。這樣游戲啟動后球會延遲約 1 秒才出現給玩家留出準備時間也讓我們能清楚看到球生成后立刻的運動軌跡?？偨Y本章為 Pong 游戲完成了三件核心工作定義并注冊Ball組件以純數據速度、半徑描述球實體通過initialize_ball在競技場中央組裝實體精靈索引1對應精靈圖中的第二個精靈兩個系統(tǒng)驅動游戲邏輯MoveBallsSystem讀取Time資源的delta_seconds實現幀率無關移動BounceSystem通過矩形膨脹 點在矩形內的測試同時處理上下邊界與擋板碰撞并用速度方向檢查避免重復反彈兩系統(tǒng)按依賴關系碰撞依賴移動注冊進DispatcherBuilder延遲生成球利用Pong狀態(tài)結構體的ball_spawn_timer: Optionf32字段與每幀執(zhí)行的update方法實現啟動后延遲 1 秒生成球解決開局即丟球的問題。教程正文對應的完整代碼即倉庫中的 pong_tutorial_04 示例含 pong.rs、systems/move_balls.rs、systems/bounce.rs、systems/paddle.rs 與 main.rs對照閱讀可以同時看到教程講述的經典 API 與倉庫當前使用的SystemBuilder新 API 兩種寫法。下一篇教程將在此基礎上增加玩家失分判定與計分系統(tǒng)敬請繼續(xù)閱讀 pong-tutorial-05。贊分享【免費下載鏈接】amethystData-oriented and>項目地址https://gitcode.com/gh_mirrors/ame/amethyst點擊查看免費下載相關推薦用 Amethyst 編寫 Pong 教程第 4 步讓球移動與反彈用 Amethyst 編寫 Pong 教程第 4 步讓球移動與反彈 本篇文章以倉庫中 examples/pong_tutorial_04 https://liMilkdown 文檔自動生成系統(tǒng)解析define.md 遞歸宏模板如何驅動全量 API 文檔渲染Milkdown 文檔自動生成系統(tǒng)解析define.md 遞歸宏模板如何驅動全量 API 文檔渲染 本篇技術指南圍繞 Milkdown 倉庫中 docs/teAmethyst 實體與組件ECS完全指南從 Entity 到 Archetype 與 Tag 的實戰(zhàn)解析Amethyst 實體與組件ECS完全指南從 Entity 到 Archetype 與 Tag 的實戰(zhàn)解析 導讀 本文圍繞 Amethyst 數據驅動游戲上一篇Maestro 錄制功能實操從跑通 Flow 到產出演示視頻下一篇推薦開源項目Test Device Policy Control - 測試您的Android企業(yè)級管理平臺創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考