مقدمه‌ای بر Flame با Flutter

۱. مقدمه

آنچه خواهید ساخت

‫Flame یک موتور بازی دوبعدی مبتنی بر Flutter است. در این codelab، بازی‌ای خواهید ساخت که از یکی از بازی‌های ویدیویی کلاسیک دهه ۷۰، یعنی Breakout اثر استیو وازنیاک، الهام گرفته است. بااستفاده از Google Antigravity، گام‌به‌گام به عامل دستور می‌دهید تا Flame Components را برای خفاش، توپ، و آجرها بسازد، حرکت خفاش را با Flame Effects پویانمایی کند، و Flame را با سیستم مدیریت وضعیت Flutter ادغام کند.

وقتی تکمیل شد، بازی شما باید شبیه این گیف پویانمایی‌شده باشد، هرچند کمی کندتر:

ضبط صفحه‌نمایش از بازی تکمیل‌شده آجرشکن درحال اجرا، با سرعت بسیار زیاد.

بازی تکمیل‌شده شما الزامات زیر را برآورده می‌کند:

  • در هر شش پلاتفرمی که Flutter پشتیبانی می‌کند کار می‌کند: Android،‏ iOS،‏ Linux،‏ macOS،‏ Windows، و وب.
  • بااستفاده از حلقه بازی Flame، حداقل ۶۰ فریم در ثانیه را حفظ می‌کند.
  • از بسته‌های Flutter مانند google_fonts و flutter_animate برای بازآفرینی حس بازی‌های آرکید دهه‌های ۷۰ و ۸۰ استفاده می‌کند.

سفر یادگیری شما

این codelab شما را گام‌به‌گام در ساختن بازی راهنمایی می‌کند:

  1. راه‌اندازی محیط Flutter - Flutter و Google Antigravity را برای پلاتفرم هدف خود پیکربندی کنید.
  2. ایجاد پروژه - از Antigravity بخواهید یک پروژه Flutter خالی با Flame،‏ flutter_animate،‏ google_fonts، و material_ui ایجاد کند.
  3. ایجاد بازی - دوربینی با وضوح ثابت پیکربندی کنید و مؤلفه PlayArea را به دنیای بازی اضافه کنید.
  4. نمایش توپ - افزودن مؤلفه متحرک Ball که توسط حلقه بازی Flame و بردارهای سرعت هدایت می‌شود.
  5. جهیدن به اطراف - تشخیص برخورد و جعبه‌های برخورد را فعال کنید تا توپ از دیوارها بجهد.
  6. Get bat on ball - Add a player-controlled Bat supporting drag and keyboard input with MoveToEffect.
  7. دیوار را خراب کنید - شبکه‌ای از Brick مؤلفه تولید کنید و سرعت توپ را با شکستن آجرها افزایش دهید.
  8. برنده شدن در بازی - مدیریت وضعیت‌های بازی و نمایش هم‌پوشانی‌های ابزاره Flutter قدیمی با GameWidget.controlled.
  9. ثبت امتیاز - همگام‌سازی امتیاز بازیکن با میانای کاربر Flutter بااستفاده از ValueNotifier و پویانمایی کردن هم‌پوشانی‌ها با flutter_animate.

آنچه خواهید آموخت

  • نحوه مشارکت با Google Antigravity برای ساختن و سفارشی‌سازی تکراری بازی Flame.
  • نحوه عملکرد اصول Flame، با شروع از GameWidget.
  • نحوه استفاده از حلقه بازی برای حرکت مستقل از نرخ فریم.
  • نحوه عملکرد Componentهای Flame (شبیه به Widgetهای Flutter).
  • نحوه تشخیص و پاسخ به برخوردها بااستفاده از جعبه‌های برخورد.
  • نحوه استفاده از Effect برای پویانمایی و برداشتن Component.
  • نحوه هم‌پوشانی Flutter Widgets روی بازی Flame.
  • نحوه ادغام Flame با مدیریت وضعیت Flutter.

پیش‌نیازها

  • آشنایی اولیه با نحو Flutter و Dart.

۲. راه‌اندازی محیط Flutter

ویرایشگر

این codelab از Google Antigravity به‌عنوان محیط توسعه هوش‌واره‌ای‌محور شما استفاده می‌کند. در هر مرحله، از Antigravity می‌خواهید مؤلفه‌های بازی‌تان را تولید یا تکامل دهد، مفاهیم کلیدی Flame را در کد تولیدشده مرور می‌کنید، و به‌طور اختیاری، انواع بازی‌های آرکید الهام‌گرفته از دوران‌های مختلف را کاوش می‌کنید.

هدف توسعه را انتخاب کنید

Flutter برای پلاتفرم‌های متعدد برنامه تولید می‌کند. برنامه‌تان می‌تواند در هریک از سیستم‌عامل‌های زیر اجرا شود:

  • iOS
  • Android
  • Windows
  • macOS
  • Linux
  • وب

روال معمول این است که یک سیستم‌عامل را به‌عنوان هدف توسعه خود انتخاب کنید. این سیستم‌عاملی است که برنامه شما درطول توسعه روی آن اجرا می‌شود.

رایانه کیفی‌ای با برچسب «دستگاه توسعه» که با کابل به تلفنی با برچسب «دستگاه هدف» متصل شده است.

برای مثال، فرض کنید از رایانه کیفی Windows برای توسعه برنامه Flutter خود استفاده می‌کنید. اگر Android را به‌عنوان هدف توسعه خود انتخاب کنید، یک دستگاه Android را با کابل USB به رایانه کیفی Windows خود متصل می‌کنید و برنامه درحال توسعه شما روی آن دستگاه Android متصل (یا در شبیه‌ساز Android) اجرا می‌شود. یا می‌توانید Windows را به‌عنوان هدف توسعه انتخاب کنید که برنامه درحال توسعه شما را به‌عنوان برنامه Windows رایانه‌ای درکنار ویرایشگرتان اجرا می‌کند.

قبل‌از ادامه دادن، انتخاب کنید. همیشه می‌توانید بعداً برنامه‌تان را در سیستم‌عامل‌های دیگر اجرا کنید. انتخاب هدف توسعه باعث می‌شود مرحله بعدی روان‌تر انجام شود.

نصب Flutter

به‌روزترین دستورالعمل‌ها برای نصب Flutter SDK همیشه در docs.flutter.dev دردسترس است.

دستورالعمل‌های موجود در وب‌سایت Flutter شامل نصب کیت توسعه نرم‌افزار، ابزارهای خاص پلاتفرم، و افزایه‌های ویرایشگر می‌شود. برای این codelab، نرم‌افزار زیر را نصب کنید:

  1. Flutter SDK
  2. ‫Google Antigravity با افزونه رسمی Dart و Flutter فعال‌شده (در Plugin Marketplace در بخش ساخت با Google دردسترس است).
  3. نرم‌افزار کامپایلر برای هدف توسعه انتخابی شما (برای مثال، Visual Studio برای هدف Windows یا Xcode برای هدف macOS یا iOS).

در مرحله بعد، از Antigravity می‌خواهید پروژه Flutter شما را ایجاد کند و بازی Flame اولیه را داربست‌بندی کند.

عیب‌یابی

اگر با مشکلات راه‌اندازی مواجه شدید، این پرسش‌ها و پاسخ‌های Stack Overflow ممکن است کمک کند:

۳. ایجاد کردن پروژه

از Antigravity بخواهید پروژه را ایجاد کند

  1. Google Antigravity را راه‌اندازی کنید و دایرکتوری خالی‌ای را که می‌خواهید بازی‌تان را در آن بسازید باز کنید (مسیری را انتخاب کنید که به امتیازهای عالی نیاز نداشته باشد یا حاوی فاصله نباشد، مثلاً پوشه‌ای در دایرکتوری خانه یا C:\src\).
  2. در پانل گپ عامل Antigravity، پیام‌واره زیر را برای ایجاد پروژه Flutter، افزودن وابستگی‌ها، و اتصال یک بازی Flame حداقلی ارسال کنید:
Create a new empty Flutter project named `brick_breaker` for a Breakout-style 2D arcade game. Add the `flame`, `flutter_animate`, `google_fonts`, and `material_ui` packages, and update `lib/main.dart` (importing `package:flame/game.dart` and `package:material_ui/material_ui.dart`) to run a basic `FlameGame` inside a `GameWidget`.

آشنایی با کد تولیدشده

Antigravity flutter create --empty را برای داربست‌بندی پروژه اجرا می‌کند، flame، flutter_animate، google_fonts، و material_ui را به pubspec.yaml اضافه می‌کند، و lib/main.dart را برای میزبانی نمونه FlameGame در GameWidget Flutter به‌روز می‌کند:

void main() {
  final game = FlameGame();
  runApp(GameWidget(game: game));
}

اجرا و آزمایش بازی

برنامه را در هدف توسعه انتخابی‌تان اجرا کنید تا مطمئن شوید همه چیز درست کار می‌کند. پنجره جدیدی با پس‌زمینه سیاه خالی نمایش می‌دهد. ساده‌ترین بازی ویدیویی جهان اکنون با نرخ ۶۰ فریم در ثانیه ارائه می‌شود!

پنجره برنامه brick_breaker با پس‌زمینه کاملاً سیاه.

۴. ساختن بازی

بازی را ارزیابی کنید

بازی‌ای که در دو بعد (2D) انجام می‌شود به منطقه بازی نیاز دارد. در این مرحله، یک منطقه بازی با ابعاد مشخص می‌سازید و از آن ابعاد برای تعیین اندازه بقیه اجزای بازی استفاده می‌کنید.

روش‌های مختلفی برای چیدمان مختصات در منطقه بازی وجود دارد. طبق یک قرارداد، جهت را از مرکز صفحه‌نمایش با مبدأ (0,0) در مرکز اندازه‌گیری می‌کنید، که در آن مقادیر مثبت موارد را در امتداد محور x به راست و در امتداد محور y به بالا حرکت می‌دهند. این استاندارد در موتورهای بازی سه‌بعدی مدرن رایج است.

وقتی بازی Breakout اصلی ساخته شد، رسم بر این بود که مبدأ در گوشه بالا سمت چپ قرار گیرد. جهت مثبت x به‌سمت راست و جهت مثبت y به‌سمت پایین است. برای وفادار ماندن به آن دوران، این بازی مبدأ را در گوشه بالا سمت چپ قرار می‌دهد.

از Antigravity بخواهید بازی و PlayArea را ایجاد کند

پیام‌واره زیر را در Antigravity ارسال کنید تا دنیای بازی و منطقه بازی با وضوح ثابت را راه‌اندازی کنید:

Create a `BrickBreaker` subclass of `FlameGame` in `lib/src/brick_breaker.dart` with a fixed-resolution camera (820x1600, defined in `lib/src/config.dart`) anchored at the top-left corner. Add a `PlayArea` rectangle component (`lib/src/components/play_area.dart`, re-exported in `lib/src/components/components.dart`) that fills the game's width and height with a warm arcade background color (`0xfff2e8cf`), and wire `BrickBreaker` up in `lib/main.dart`.

آشنایی با کد تولیدشده

PlayArea و Component شعله

جایی که Flutter دارای Widget است، Flame دارای Component است. درحالی‌که برنامه‌های Flutter از درخت‌های ابزاره تشکیل شده‌اند، بازی‌های Flame درخت‌های مؤلفه را حفظ می‌کنند.

درخت ابزاره Flutter شرحی تغییرناپذیر است که برای به‌روزرسانی لایه RenderObject تغییرپذیر و پایدار استفاده می‌شود. قطعات Flame پایدار و تغییرپذیر هستند و به‌گونه‌ای طراحی شده‌اند که مستقیماً به‌عنوان بخشی از سیستم شبیه‌سازی در lib/src/components/play_area.dart استفاده شوند:

class PlayArea extends RectangleComponent with HasGameReference<BrickBreaker> {
  PlayArea() : super(paint: Paint()..color = const Color(0xfff2e8cf));

  @override
  FutureOr<void> onLoad() async {
    super.onLoad();
    size = Vector2(game.width, game.height);
  }
}

برای کنترل کردن آشفتگی واردات هنگام افزودن مؤلفه‌های بیشتر، lib/src/components/components.dart از دستورالعمل export برای صادر کردن مجدد هر مؤلفه از یک فایل بشکه‌ای واحد استفاده می‌کند.

دوربین با وضوح ثابت و world

در lib/src/brick_breaker.dart، BrickBreaker بازی را برای استفاده از وضوح ثابت 820x1600 پیکربندی می‌کند:

class BrickBreaker extends FlameGame {
  BrickBreaker()
    : super(
        camera: CameraComponent.withFixedResolution(
          width: gameWidth,
          height: gameHeight,
        ),
      );

  @override
  FutureOr<void> onLoad() async {
    super.onLoad();
    camera.viewfinder.anchor = Anchor.topLeft;
    world.add(PlayArea());
  }
}

اندازه بازی تغییر می‌کند تا پنجره‌ای را که در آن قرار دارد پر کند و درصورت لزوم حالت سینمایی اضافه می‌کند.

در onLoad، کد دو کنش کلیدی را انجام می‌دهد:

  1. گوشه بالا سمت چپ را به‌عنوان لنگر برای viewfinder پیکربندی می‌کند (که به‌طور پیش‌فرض مرکز ناحیه به‌عنوان (0,0) است).
  2. PlayArea را به world اضافه می‌کند که همه فرزندانش را ازطریق تبدیل نمای CameraComponent نمایش می‌دهد.

اجرا و آزمایش بازی

برای دیدن تغییرات، بازراه‌اندازی سریع (یا بازراه‌اندازی کامل) انجام دهید.

پنجره برنامه brick_breaker با مستطیل PlayArea شنی‌رنگ در مرکز پنجره.

در مرحله بعد، توپی را به جهان اضافه می‌کنید و آن را به حرکت درمی‌آورید!

۵. نمایش توپ

از Antigravity بخواهید مؤلفه Ball را اضافه کند

قرار دادن توپ متحرک روی صفحه شامل تعریف مؤلفه Ball و افزودن آن به دنیای بازی است. پیام‌واره زیر را در Antigravity ارسال کنید:

Add a `Ball` circle component (`lib/src/components/ball.dart`) with a radius of 2% of the game width and a velocity vector that updates the ball's position each frame (`position += velocity * dt`). Spawn the ball at the center of the play area in `BrickBreaker.onLoad()` moving downward in a randomized direction at a consistent speed (scaled to a quarter of the game height), and enable `debugMode = true` so we can see component bounds.

آشنایی با کد تولیدشده

ثابت‌های پیکربندی مشتق‌شده

تعریف کردن ballRadius = gameWidth * 0.02 در lib/src/config.dart به‌عنوان ثابت مشتق‌شده به شما امکان می‌دهد gameWidth و gameHeight سطح بالا را اصلاح کنید تا ببینید ظاهر و حس بازی درنتیجه آن چگونه تغییر می‌کند.

حرکت مستقل از نرخ فریم در Ball

‫CircleComponent، مانند RectangleComponent، از PositionComponent مشتق می‌شود، بنابراین position آن می‌تواند در هر فریم در lib/src/components/ball.dart به‌روز شود:

  final Vector2 velocity;

  @override
  void update(double dt) {
    super.update(dt);
    position += velocity * dt;
  }

سرعت برداری یک شیء Vector2 است زیرا سرعت برداری هم سرعت و هم جهت دارد. Flame در هر قاب update را فراخوانی می‌کند و dt (زمان دلتا برحسب ثانیه از قاب قبلی) را ارسال می‌کند. ضرب کردن velocity * dt باعث می‌شود سرعت شبیه‌سازی در نرخ‌های بازآوری مختلف نمایشگر (مثلاً ۶۰ هرتز درمقابل ۱۲۰ هرتز) ثابت بماند.

درحال نرمال‌سازی سرعت اولیه

در lib/src/brick_breaker.dart، توپ از مرکز (size / 2) با سرعت تصادفی رو به پایین شروع می‌شود:

    world.add(
      Ball(
        radius: ballRadius,
        position: size / 2,
        velocity: Vector2(
          (rand.nextDouble() - 0.5) * width,
          height * 0.2,
        ).normalized()..scale(height / 4),
      ),
    );

فراخوانی normalized() یک بردار واحد (طول 1) تولید می‌کند که به همان جهت تصادفی اشاره دارد، و ..scale(height / 4) آن را مقیاس‌بندی می‌کند تا توپ همیشه با همان سرعت بدون توجه به زاویه شروع شود.

اجرا و آزمایش بازی

بازی را بازراه‌اندازی گرم کنید. با فعال بودن debugMode = true، Flame کادرهای مرزی بنفش و مختصات را در درخت مؤلفه نمایش می‌دهد:

پنجره برنامه brick_breaker با یک توپ آبی در بالای منطقه بازی به رنگ شنی، با مختصات اشکال‌زدایی حاشیه‌نویسی شده است.

اگر بازی را چند بار بازراه‌اندازی کنید، متوجه خواهید شد که توپ مستقیماً از لبه‌های منطقه بازی عبور می‌کند. برای رفع این مشکل، در مرحله بعد تشخیص برخورد را اضافه خواهید کرد.

‫۶. بالا و پایین پریدن

از Antigravity بخواهید تشخیص برخورد را اضافه کند

تشخیص برخورد به بازی شما امکان می‌دهد تا متوجه شود چه زمانی دو مؤلفه با یکدیگر تماس پیدا می‌کنند. پیام‌واره زیر را در Antigravity ارسال کنید:

Enable collision detection on `BrickBreaker` and add hitboxes to `PlayArea` and `Ball`. In `Ball.onCollisionStart`, bounce the ball off the top, left, and right walls of `PlayArea` by reversing the appropriate velocity axis, and remove the ball when it hits the bottom edge.

آشنایی با کد تولیدشده

جعبه‌های ضربه و HasCollisionDetection

افزودن HasCollisionDetection mixin به BrickBreaker، جعبه‌های برخورد مؤلفه (RectangleHitbox در PlayArea و CircleHitbox در Ball) را ردیابی می‌کند و در هر تیک بازی، فراخوانی‌های برگشتی برخورد را فعال می‌کند.

مدیریت برخورد با دیوار در Ball

در lib/src/components/ball.dart، onCollisionStart بردار سرعت توپ را هنگام برخورد با دیوار بالا، چپ، یا راست منعکس می‌کند و توپ را هنگام برخورد با پایین برمی‌دارد:

  @override
  void onCollisionStart(
    Set<Vector2> intersectionPoints,
    PositionComponent other,
  ) {
    super.onCollisionStart(intersectionPoints, other);
    if (other is PlayArea) {
      if (intersectionPoints.first.y <= 0) {
        velocity.y = -velocity.y;
      } else if (intersectionPoints.first.x <= 0) {
        velocity.x = -velocity.x;
      } else if (intersectionPoints.first.x >= game.width) {
        velocity.x = -velocity.x;
      } else if (intersectionPoints.first.y >= game.height) {
        removeFromParent();
      }
    } else {
      debugPrint('collision with $other');
    }
  }

اجرا و آزمایش بازی

بازی را بازراه‌اندازی گرم کنید. توپ را تماشا کنید که از دیوارهای چپ و راست PlayArea برمی‌گردد و وقتی به لبه پایینی می‌رسد ناپدید می‌شود.

اکنون که توپ از دیوارها برمی‌گردد، به بازیکن یک راکت بدهید تا توپ را به بالا برگرداند!

‫۷. توپ را با چوب بزنید

از Antigravity بخواهید مؤلفه Bat را اضافه کند

پیام‌واره زیر را در Antigravity ارسال کنید تا مؤلفه Bat تحت کنترل بازیکن را ایجاد کنید و برخورد توپ به چوب را مدیریت کنید:

Add a player-controlled `Bat` component (`lib/src/components/bat.dart`) positioned near the bottom of the play area (`height * 0.95`). Render it as a rounded rectangle with a `RectangleHitbox`, and let the player move it horizontally both by dragging (`DragCallbacks`) and with the left and right arrow keys (`KeyboardEvents` on `BrickBreaker` using a short `MoveToEffect`). In `Ball`, replace immediate bottom removal with a delayed `RemoveEffect(delay: 0.35)`, and when the ball hits the `Bat`, reverse its vertical velocity and deflect its horizontal velocity based on how far from the bat's center the ball struck.

آشنایی با کد تولیدشده

پرداز زدن سفارشی، کشیدن، و MoveToEffect در Bat

برخلاف PlayArea و Ball، Bat در lib/src/components/bat.dart مستقیماً PositionComponent را گسترش می‌دهد و render را لغو می‌کند تا مستطیلی با گوشه‌های گرد (RRect) ترسیم کند:

  @override
  void render(Canvas canvas) {
    super.render(canvas);
    canvas.drawRRect(
      RRect.fromRectAndRadius(Offset.zero & size.toSize(), cornerRadius),
      _paint,
    );
  }

Offset.zero & size.toSize() از اپراتور & در Offset و Size برای ساختن Rect استفاده می‌کند.

برای ورودی، Bat از دو روش پشتیبانی می‌کند:

  • کشیدن با موشواره و لمس بااستفاده از DragCallbacks و onDragUpdate.
  • حرکت صفحه‌کلید بااستفاده از moveBy(double dx)، که Flame MoveToEffect را برای پویانمایی روان خفاش در ۱۰۰ میلی‌ثانیه پیوست می‌کند:
  void moveBy(double dx) {
    add(
      MoveToEffect(
        Vector2((position.x + dx).clamp(0, game.width), position.y),
        EffectController(duration: 0.1),
      ),
    );
  }

برداشتن با تأخیر و پرش زاویه‌دار راکت در Ball

در lib/src/components/ball.dart، دو بهبود باعث می‌شود تعامل با توپ بسیار بهتر شود:

  1. جایگزین کردن removeFromParent() با add(RemoveEffect(delay: 0.35)) به توپ اجازه می‌دهد قبل‌از ناپدید شدن، از لبه پایینی عبور کند.
  2. هنگام برخورد با Bat، velocity.x براساس جایی که توپ به راکت برخورد کرده است نسبت‌به مرکز راکت تنظیم می‌شود:
    } else if (other is Bat) {
      velocity.y = -velocity.y;
      velocity.x =
          velocity.x +
          (position.x - other.position.x) / other.size.x * game.width * 0.3;
    }

اجرا و آزمایش بازی

بازی را بازراه‌اندازی گرم کنید. با کشیدن راکت با موشواره یا انگشت، یا با فشار دادن کلیدهای چپ‌بر و راست‌بر، راکت را حرکت دهید و توپ را به‌سمت بالای صفحه برگردانید.

اکنون که چوبی برای ضربه زدن به توپ دارید، دیواری از آجرها را برای شکستن اضافه کنید!

‫۸. دیوار را خراب کنید

از Antigravity بخواهید Bricks را اضافه کند

پیام‌واره زیر را در Antigravity ارسال کنید تا مؤلفه Brick را ایجاد کنید، شبکه آجری را بچینید، و سرعت توپ را با شکستن آجرها افزایش دهید:

Create a `Brick` rectangle component (`lib/src/components/brick.dart`) with a hitbox and add a 10-column by 5-row grid of colored bricks across the top of the play area using constants in `lib/src/config.dart`. When the ball collides with a brick, remove the brick, reflect the ball's velocity off the side of the brick it hit, and multiply the ball's velocity by a `difficultyModifier` (such as `1.03`) so the game speeds up. When the last brick is destroyed, remove the ball and bat from the world.

آشنایی با کد تولیدشده

برداشتن عنصر صف‌بندی‌شده و بررسی برد

در lib/src/components/brick.dart، Brick.onCollisionStart آجر را برمی‌دارد و بررسی می‌کند که آیا آخرین آجر در جهان بوده است یا نه:

  @override
  void onCollisionStart(
    Set<Vector2> intersectionPoints,
    PositionComponent other,
  ) {
    super.onCollisionStart(intersectionPoints, other);
    removeFromParent();

    if (game.world.children.query<Brick>().length == 1) {
      game.world.removeAll(game.world.children.query<Ball>());
      game.world.removeAll(game.world.children.query<Bat>());
    }
  }

چرا بررسی query().length == 1 را پس‌از فراخوانی removeFromParent() مقایسه می‌کند؟ زیرا برداشتن مؤلفه در Flame یک فرمان صف‌بندی‌شده است—آجر فقط پس‌از اتمام فراخوانی برگشتی فعلی، قبل‌از تیک بازی بعدی، از درخت مؤلفه برداشته می‌شود.

منحنی دشواری در Ball

وقتی Ball با Brick در lib/src/components/ball.dart برخورد می‌کند، محور سرعت مناسب را منعکس می‌کند و بردار سرعت را در difficultyModifier (1.03) ضرب می‌کند، و به‌تدریج سرعت توپ را با هر آجر شکسته افزایش می‌دهد:

    } else if (other is Brick) {
      if (position.y < other.position.y - other.size.y / 2) {
        velocity.y = -velocity.y;
      } else if (position.y > other.position.y + other.size.y / 2) {
        velocity.y = -velocity.y;
      } else if (position.x < other.position.x) {
        velocity.x = -velocity.x;
      } else if (position.x > other.position.x) {
        velocity.x = -velocity.x;
      }
      velocity.setFrom(velocity * difficultyModifier);
    }

اجرا و آزمایش بازی

بازی را بازراه‌اندازی سریع کنید تا دیوار آجری کامل را در عمل ببینید:

بازی brick_breaker با توپ، چوب، و آجرهای رنگی در منطقه بازی با برچسب‌های اشکال‌زدایی.

سپس، بااستفاده از ابزاره‌های Flutter، رونهادهای خوشامدگویی، پایان بازی، و برد را اضافه خواهید کرد!

‫۹. برنده شدن در بازی

از Antigravity بخواهید رونهادهای PlayState و Flutter را اضافه کند

در این مرحله، یک شمارش PlayState را معرفی می‌کنید، بازی Flame را در یک ابزاره GameApp Flutter با سبک‌بندی و با هم‌پوشانی‌ها جاسازی می‌کنید، و اجازه‌های شبکه پلاتفرم را برای google_fonts پیکربندی می‌کنید. پیام‌واره زیر را در Antigravity ارسال کنید:

Add a `PlayState` enum (`welcome`, `playing`, `gameOver`, `won`) to `BrickBreaker` that synchronizes with Flame's `overlays`, turn off `debugMode`, and move spawning the ball, bat, and bricks into a `startGame()` method triggered by tapping the screen (`TapCallbacks`) or pressing Space or Enter. Transition to `gameOver` when the ball exits the bottom and `won` when the final brick breaks. Then create a Flutter wrapper `GameApp` (`lib/src/widgets/game_app.dart`, importing `package:material_ui/material_ui.dart`) using the `'Press Start 2P'` Google Font and a gradient background that displays `GameWidget` overlays for `'TAP TO PLAY'`, `'G A M E   O V E R'`, and `'Y O U   W O N ! ! !'`. Also add the required Android and macOS network permissions for `google_fonts`.

آشنایی با کد تولیدشده

مدیریت هم‌پوشانی‌ها با PlayState

در lib/src/brick_breaker.dart، تنظیم‌کننده playState وضعیت بازی را با مدیر overlays Flame همگام‌سازی می‌کند:

  late PlayState _playState;
  PlayState get playState => _playState;
  set playState(PlayState playState) {
    _playState = playState;
    switch (playState) {
      case PlayState.welcome:
      case PlayState.gameOver:
      case PlayState.won:
        overlays.add(playState.name);
      case PlayState.playing:
        overlays.remove(PlayState.welcome.name);
        overlays.remove(PlayState.gameOver.name);
        overlays.remove(PlayState.won.name);
    }
  }

با جدا کردن startGame() از onLoad()، بازیکن می‌تواند هروقت خواست با تک‌ضرب زدن روی صفحه (onTapDown) یا فشار دادن کلید «فاصله» یا «ورود»، بازی را شروع کند یا ازنو شروع کند.

درحال نگاشت هم‌پوشانی‌ها در GameWidget

در lib/src/widgets/game_app.dart، GameWidget.controlled نمونه BrickBreaker را می‌سازد و هر نام PlayState را به یک هم‌پوشانی ابزاره Flutter نگاشت می‌کند:

child: GameWidget.controlled(
  gameFactory: BrickBreaker.new,
  overlayBuilderMap: {
    PlayState.welcome.name: (context, game) => Center(
      child: Text(
        'TAP TO PLAY',
        style: Theme.of(context).textTheme.headlineLarge,
      ),
    ),
    // ...
  },
),

هر کلید در overlayBuilderMap باید با نام هم‌پوشانی ارسال‌شده به overlays.add(...) و overlays.remove(...) مطابقت داشته باشد.

اجرا و آزمایش بازی

برنامه را متوقف و دوباره اجرا کنید (چون اجازه‌های شبکه پلاتفرم برای google_fonts به‌روز شده است). درستی‌سنجی کنید که 'TAP TO PLAY' هنگام راه‌اندازی نشان داده می‌شود، با تک‌ضرب زدن یا فشار دادن کلید Space بازی شروع می‌شود، و با ازدست دادن توپ 'G A M E O V E R' نمایش داده می‌شود.

‫۱۰. حفظ امتیاز

از Antigravity بخواهید کارت امتیاز و رونهادهای پویانمایی‌شده را اضافه کند

در این مرحله نهایی، امتیاز بازیکن را از Flame به Flutter بااستفاده از ValueNotifier نمایش می‌دهید و هم‌پوشانی‌ها را با flutter_animate جلا می‌دهید. پیام‌واره زیر را در Antigravity ارسال کنید:

Track the player's score in `BrickBreaker` using a `ValueNotifier<int> score` that resets in `startGame()` and increments whenever a brick is broken. Using `package:material_ui/material_ui.dart`, create a `ScoreCard` widget (`lib/src/widgets/score_card.dart`) above the `GameWidget` that listens to `score`, and an `OverlayScreen` widget (`lib/src/widgets/overlay_screen.dart`) using `flutter_animate` to slide in the overlay title and pulse the subtitle in and out.

آشنایی با کد تولیدشده

پل زدن از وضعیت Flame به Flutter با ValueNotifier

در lib/src/brick_breaker.dart، BrickBreaker final ValueNotifier score = ValueNotifier(0); را نشان می‌دهد که در startGame() بازنشانی می‌شود و هربار که Brick زده می‌شود افزایش می‌یابد.

در lib/src/widgets/score_card.dart، ScoreCard از ValueListenableBuilder استفاده می‌کند، بنابراین فقط نوشتار امتیاز هنگام تغییر score.value بازسازی می‌شود:

  @override
  Widget build(BuildContext context) {
    return ValueListenableBuilder<int>(
      valueListenable: score,
      builder: (context, score, child) {
        return Padding(
          padding: const EdgeInsets.fromLTRB(12, 6, 12, 18),
          child: Text(
            'Score: $score'.toUpperCase(),
            style: Theme.of(context).textTheme.titleLarge!,
          ),
        );
      },
    );
  }

درحال پویانمایی کردن رونهادها با flutter_animate

در lib/src/widgets/overlay_screen.dart، OverlayScreen جلوه‌های flutter_animate را به ابزاره‌های استاندارد Text زنجیر می‌کند تا عنوان را به‌صورت لغزشی وارد کند و زیرنویس را به‌صورت ضربانی نمایش دهد:

Text(
  title,
  style: Theme.of(context).textTheme.headlineLarge,
).animate().slideY(duration: 750.ms, begin: -3, end: 0),
const SizedBox(height: 16),
Text(subtitle, style: Theme.of(context).textTheme.headlineSmall)
    .animate(onPlay: (controller) => controller.repeat())
    .fadeIn(duration: 1.seconds)
    .then()
    .fadeOut(duration: 1.seconds),

برای بررسی دقیق‌تر قدرت flutter_animate و پویانمایی‌های Flutter، به سند بسته flutter_animate و codelab پویانمایی در Flutter مراجعه کنید.

اجرا و آزمایش بازی

بازی را بازراه‌اندازی گرم کنید. با آماده شدن همه چیز، اکنون می‌توانید بازی آجرشکن خود را در هریک از شش پلاتفرم هدف Flutter بازی کنید:

بازی brick_breaker که هم‌پوشانی خوشامدگویی را نشان می‌دهد و از کاربر دعوت می‌کند برای بازی کردن روی صفحه تک‌ضرب بزند

بازی brick_breaker که رونهاد «بازی تمام شد» را روی راکت و آجرهای باقی‌مانده نشان می‌دهد

‫۱۱. تبریک می‌گوییم

تبریک! بااستفاده از Flutter،‏ Flame، و Google Antigravity یک بازی کامپیوتری آرکید دوبعدی کامل ساختید.

آنچه ساخته‌اید

  • دنیای بازی Flame دوبعدی با وضوح ثابت (BrickBreaker و PlayArea) که به‌طور تمیز در تلفن همراه، رایانه، و وب مقیاس‌بندی و جعبه‌بندی می‌شود.
  • مؤلفه‌های فیزیک و برخورد (Ball، Bat، و Brick) بااستفاده از HasCollisionDetection، جعبه‌های برخورد، و به‌روزرسانی‌های سرعت مستقل از نرخ فریم.
  • کنترل‌های پخش‌کننده چندحالتی و جلوه‌های Flame که کشیدن با موشواره و لمس (DragCallbacks) را با پویانمایی‌های MoveToEffect صفحه‌کلیدمحور و پاک‌سازی با تأخیر RemoveEffect ترکیب می‌کند.
  • ادغام میانای کاربر Flutter بااستفاده از هم‌پوشانی‌های GameWidget.controlled، مدیریت وضعیت ValueNotifier برای به‌روزرسانی‌های هم‌زمان امتیاز، google_fonts، و flutter_animate.

از اینجا کجا برویم

به پیام‌واره دادن به Antigravity ادامه دهید تا بازی را به سلیقه خودتان بسازید! چند ایده برای امتحان کردن:

  • جلوه‌های صوتی بازی‌های قدیمی: از Antigravity بخواهید flame_audio (یا جلوه‌های صوتی ترکیبی) را برای ضربه‌های راکت، برخورد به دیوار، و تخریب آجرها اضافه کند.
  • تقویت‌کننده‌ها و چندتوپی: کپسول‌های تقویت‌کننده را که از آجرهای شکسته می‌افتند و باعث پهن‌تر شدن راکت، کند شدن توپ، یا تقسیم شدن توپ به سه توپ می‌شوند، ایجاد کنید.
  • چندین سطح و امتیاز بالا: امتیاز بالای بازیکن را بااستفاده از shared_preferences حفظ کنید و چیدمان‌های آجری جدیدی برای سطوح بعدی طراحی کنید.

حالا چه می‌شود؟

برخی‌از این codelabهای مرتبط را بررسی کنید:

مطالعه بیشتر