شارك المقالة
لعبة صيد السمك Flutter باستخدام Flame: شرح Deep Fishing

لعبة صيد السمك Flutter باستخدام Flame: شرح Deep Fishing

شرح لعبة صيد السمك Flutter في مشروع Deep Fishing باستخدام Flame، مع التحكم والكاميرا والتصادم والنقاط ومتطلبات إضافة أزرار لمس…

شرح لعبة صيد السمك Flutter في مشروع Deep Fishing باستخدام Flame، مع التحكم والكاميرا والتصادم والنقاط ومتطلبات إضافة أزرار لمس للهاتف.

تحديد المصدر بعد انتقال المستودع

يعرض المشروع نفسه باسم Deep Fishing، وأصبح رابط المستودع الأصلي ينتقل إلى حساب teddy-chavez. استخدم الرابط المباشر الحالي لتقليل التحويلات، مع الحفاظ على رابط هذه المقالة نفسه. المشروع صغير من حيث عدد الملفات: main وfish وplayer وmap، ولذلك يصلح لتتبع حلقة لعبة وكاميرا ومكونات متحركة. قصر المصدر لا يعني أنه يوفر كل إعدادات الإنتاج أو أن كل dependency مذكورة فيه مستخدمة بالفعل.

تجهيز الأصول والإصدار

يعلن pubspec في النسخة المراجعة Flame وflame_forge2d وصور السمك والخطاف واللاعب. راجع أسماء الأصول ونسخ الحزم وملف القفل قبل تشغيله أو ترقيته. ملفات Dart التي فحصناها تعتمد مكونات Flame والتصادمات والتأثيرات؛ لا نصف اللعبة بمحاكاة Forge2D لمجرد وجود الحزمة في الاعتماديات. ابدأ بتشغيل مشهد واحد، ثم افحص حركة الخطاف والسمك قبل إضافة رسوم أو أصوات جديدة.

التحكم الحالي وما يلزم للهاتف

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

الزمن والكاميرا وتوليد الخريطة

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

التصادم والعودة وتسجيل الصيد

يفصل المصدر حالات intro وplaying وgameOver، ويحول أول تصادم مع السمك الجولة إلى مسار عودة. هذا يجعل gameOver اسمًا لحالة حركة أيضًا، لا مجرد توقف نهائي كما قد يتوقع القارئ. في setScore توجد نقاط مرتبطة بالعمق وإضافة عشر نقاط لكل سمكة معدودة. إذا غيرت القاعدة فافصل مقياس العمق عن مكافأة الصيد، ولا تعتمد على callback قد يتكرر لإضافة مكافأة غير محدودة لنفس السمكة.

تصحيح إعادة الجولة وإدارة التأخير

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

خطة اختبار الصيد

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

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

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

enum FishingPhase { ready, descending, returning }

class FishingRound {
  FishingPhase _phase = FishingPhase.ready;
  final Set<String> _caught = {};
  int _depthPoints = 0;
  int get score => _depthPoints + _caught.length * 10;
  FishingPhase get phase => _phase;
  bool start() {
    if (_phase != FishingPhase.ready) return false;
    _phase = FishingPhase.descending;
    return true;
  }
  void updateDepth(int depthPoints) {
    if (depthPoints < 0) throw ArgumentError.value(depthPoints);
    if (_phase == FishingPhase.descending) _depthPoints = depthPoints;
  }
  bool beginReturn() {
    if (_phase != FishingPhase.descending) return false;
    _phase = FishingPhase.returning;
    return true;
  }
  bool catchFish(String fishId) {
    if (fishId.isEmpty) throw ArgumentError('Fish ID is required');
    if (_phase != FishingPhase.returning) return false;
    return _caught.add(fishId);
  }
  void reset() {
    _caught.clear(); _depthPoints = 0; _phase = FishingPhase.ready;
  }
}
// Illustrative round state only; the Flame layer owns collision and movement.

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

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

git clone https://github.com/teddy-chavez/flame_6_years_game.git
cd flame_6_years_game
flutter --version
flutter pub get
flutter analyze
flutter run

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

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

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