شارك المقالة
كود Flappy Bird Flutter باستخدام Flame: الحركة والتصادم والنقاط

كود Flappy Bird Flutter باستخدام Flame: الحركة والتصادم والنقاط

مراجعة كود Flappy Bird Flutter باستخدام Flame، مع تشغيل المصدر وفهم الحركة والتصادم واحتساب المرور مرة واحدة وإعادة ضبط الجولة.

مراجعة كود Flappy Bird Flutter باستخدام Flame، مع تشغيل المصدر وفهم الحركة والتصادم واحتساب المرور مرة واحدة وإعادة ضبط الجولة.

ماذا يحتوي المشروع الأصلي؟

يستخدم مصدر HeyFlutter محرك Flame وحزمة flame_audio، ويقسم العمل بين كائن اللعبة والطائر والأرض والأنابيب وشاشات القائمة ونهاية الجولة. هذه البنية تجعل المشروع مناسبًا لتتبع دورة لعب صغيرة من الإدخال إلى تحديث الحالة والرسم. لا يعتمد الشرح على عدد تنزيلات تاريخي غير موثق أو وعد بأن أي نسخة ستعمل فورًا على جميع المنصات؛ التركيز هنا على التنفيذ الموجود وما ينبغي اختباره عند تعديله.

تجهيز Flutter والأصول

نزّل المستودع كاملًا، ثم راجع pubspec.yaml وملف القفل قبل تشغيل الأوامر. يعلن المصدر flame بإصدار من سلسلة 1.10 وملفات صور وصوت وخط Game داخل assets. حذف مجلد أو تغيير حالة الأحرف في اسمه قد يمنع التحميل حتى إن كان Dart سليمًا. عند ترقية Flame راجع دليل الإصدار الذي ستعتمده؛ لا تستبدل mixin أو اسم callback من توثيق أحدث دون مراجعة مواضع استخدامه في المشروع.

الحركة المرتبطة بالزمن والإدخال

تتحرك الأنابيب في المصدر باستخدام السرعة مضروبة في dt، وهو الزمن بين تحديثين، بينما يستخدم الطائر تأثير حركة عند النقر وهبوطًا في update. هذا نموذج تعليمي، وليس محاكاة فيزيائية دقيقة لمجرد وجود متغير اسمه gravity. افصل سرعة السقوط عن قوة القفزة وعن معدل توليد العوائق، ثم جرّب النتيجة على أجهزة ذات معدلات إطارات مختلفة. إدخال النقر يجب أن يعمل أثناء الجولة فقط، لا أن يضيف تأثيرات جديدة فوق شاشة الخسارة.

التصادم وحالة نهاية الجولة

يستخدم الطائر hitbox ويرسل التصادم إلى gameOver التي توقف المحرك وتعرض overlay. يجب أن يكون إنهاء الجولة عملية واحدة؛ تكرار callbacks للتصادم لا ينبغي أن يشغل صوت الخسارة أو يفتح الشاشة عدة مرات. لا تفترض أن شكل sprite يطابق منطقة التصادم تمامًا، بل أظهر hitboxes مؤقتًا في التطوير وجرّب حواف الطائر والأرض والأنبوب. عالج أيضًا الخروج من التطبيق والعودة إليه حتى لا يقفز dt أو يكمل الصوت من جلسة سابقة.

تصحيح احتساب النقاط

النقر ليس نقطة، ولا توجد نقطة إضافية لكل حركة ناجحة في الكود الأصلي. يزيد PipeGroup النقاط عند خروجه من يسار الشاشة وإزالته، وهذا يختلف عن تسجيلها لحظة مرور الطائر خلف الحافة اليمنى للأنبوب. اختر قاعدة واحدة ووضحها، ثم اجعل لكل مجموعة أنابيب معرفًا وحالة تسجيل تمنع تكرار النقطة في عدة إطارات. المثال المستقل أدناه يشرح هذه الحماية فقط، ولا يدعي أنه بديل عن كل ملفات لعبة Flame.

إعادة البداية دون بقايا الجولة

عند إعادة المحاولة صفّر النقاط وأعد موضع الطائر وسرعته أو تأثيراته النشطة، وأزل الأنابيب القديمة وأعد مؤقت توليدها. لا تستخدم علم تصادم مشتركًا يمسحه أول أنبوب فيمنع بقية العوائق من التنظيف؛ ربط العناصر بمعرف الجولة أو إزالتها بقائمة واضحة أكثر قابلية للتتبع. افحص هل overlay وإيقاف الصوت واستئناف المحرك تتم بالترتيب المطلوب، بدل الاكتفاء بتغيير النص الظاهر إلى صفر.

خطة اختبار وتطوير صغيرة

ابدأ بمرور واحد وخسارة واحدة وإعادة محاولة، ثم كرر العودة للقائمة واللعب عدة مرات. اختبر المرور على الحد نفسه مرتين وإضافة أنبوب جديد بمعرف مختلف وعدم زيادة النقاط بعد الخسارة. اجعل رفع الصعوبة تدريجيًا ومعلنًا في الكود؛ لا تنسب زيادة سرعة أو تضييق فجوات للمصدر إن لم تكن مبرمجة. عند إضافة رسومات أو أصوات جديدة راجع حقوقها وملف الترخيص الموجود؛ إتاحة المستودع لا تكفي وحدها لوصف كل مواده بأنها حرة لإعادة النشر.

مثال مستقل للمنطق وحدوده

الكود التالي يعزل الفكرة المذكورة لاختبارها دون تشغيل المصدر الخارجي؛ لا يرسم اللعبة ولا يهيئ كل خدماتها. وصله بطبقة العرض بعد مراجعة الحالات المشروحة أعلاه.

enum RunPhase { ready, playing, ended }

class RunScore {
  RunPhase _phase = RunPhase.ready;
  final Set<String> _passed = {};
  int get score => _passed.length;
  RunPhase get phase => _phase;

  bool start() {
    if (_phase != RunPhase.ready) return false;
    _phase = RunPhase.playing;
    return true;
  }
  bool registerPass({required String obstacleId,
    required double obstacleRight, required double birdLeft}) {
    if (obstacleId.isEmpty || !obstacleRight.isFinite || !birdLeft.isFinite) {
      throw ArgumentError('A stable ID and finite positions are required');
    }
    if (_phase != RunPhase.playing || obstacleRight >= birdLeft) return false;
    return _passed.add(obstacleId);
  }
  bool end() {
    if (_phase != RunPhase.playing) return false;
    _phase = RunPhase.ended;
    return true;
  }
  void reset() { _passed.clear(); _phase = RunPhase.ready; }
}
// Use a unique obstacle ID per round. Jumping does not award a point.
// This score model does not implement rendering, movement or hitboxes.

بدء مراجعة المشروع الأصلي

راجع README والحزم والأصول والمنصة قبل التشغيل. هذه أوامر مقترحة لنسخة مستقلة، ولا تعني أن بناء المستودع الخارجي قد اختبر على جميع الإصدارات.

git clone https://github.com/HeyFlutter-Public/flappy_bird_game.git
cd flappy_bird_game
flutter --version
flutter pub get
flutter analyze
flutter run

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع