Challenge-keyboardVersions

🎮 لعبة تحدي الحروف العربية - تطبيق تعليمي سعودي

---

• ✅ إصلاح منطق السكور: النقاط تظهر وتزيد بشكل صحيح دائماً بعد الفوز، وتنعكس فوراً في شاشة الفوز.
• ✅ منطق فوز متعدد: يدعم الفوز بمسار متصل حقيقي، أو نمط ثابت (predefined pattern)، أو خط متصل (أفقي/رأسي/قطري) بطول 4 أو أكثر.
• ✅ شاشة الفوز التلقائية: تظهر شاشة الفوز تلقائياً بعد انتهاء أنيميشن المسار الفائز (وميض)، مع عرض السكور الصحيح.
• ✅ Responsive للأعمدة الجانبية: الأعمدة الجانبية (الأحمر/الأخضر) تتغير تلقائياً لتكون رفيعة على الموبايل، وكبيرة على الديسكتوب.
• ✅ إصلاح Overflow والشريط الجانبي: لا يظهر أي شريط غريب أو Overflow على الموبايل، مع الحفاظ على التصميم الأصلي في الديسكتوب.
• ✅ تحسين تجربة الموبايل: كل عناصر اللعبة تتكيف تلقائياً مع الشاشات الصغيرة بدون التأثير على تجربة الديسكتوب أو التابلت.
• ✅ تحسين الأنيميشن والمؤثرات: مؤثرات الفوز والوميض والصوت أصبحت أكثر سلاسة وتزامناً مع منطق الفوز.

---

تطبيق تعليمي تفاعلي لتعلم الحروف العربية بطريقة ممتعة، مصمم خصيصاً للثقافة السعودية.

✨ الميزات

• 🎯 لعبة الفرق: تنافس بين فريقين (أخضر/أحمر)
• 🏛️ أسئلة سعودية: أسئلة عن المدن، الأكلات، القبائل، والمواقع السعودية
• ⌨️ كيبورد تفاعلي: لوحة مفاتيح مدمجة داخل التطبيق
• ⏱️ مؤقت تفاعلي: 10 ثواني لكل سؤال
• 🎨 تصميم جذاب: واجهة عربية جميلة مع دعم RTL
• 📱 متوافق مع Simulator: يعمل مباشرة على Xcode iOS Simulator

🚀 كيفية التشغيل على Xcode Simulator

المتطلبات

• Xcode 14.0 أو أحدث
• macOS 12.0 أو أحدث
• لا تحتاج Apple Developer Account

خطوات التشغيل

1. فتح المشروع

   # افتح ملف المشروع
   open HarfChallengeKeyboard.xcodeproj
   

2. اختيار Simulator
   • اختر iOS Simulator من قائمة الأجهزة
   • يفضل iPhone 14 أو أحدث للحصول على أفضل تجربة
3. بناء وتشغيل التطبيق
   • اضغط Cmd + R أو زر ▶️ في Xcode
   • انتظر حتى يتم البناء والتشغيل
4. استخدام التطبيق
   • ستظهر شاشة الترحيب مع خيارين:
     • “ابدأ اللعبة”: للعبة الفرق التنافسية
     • “كيبورد الحروف”: للكيبورد التفاعلي

🎮 كيفية اللعب

لعبة الفرق

1. اختر فريقك (أخضر أو أحمر)
2. اضغط على أي حرف من الشبكة
3. اقرأ السؤال وأجب عليه خلال 10 ثواني
4. الحرف سيتلون بلون فريقك بعد الإجابة
5. استمر حتى تنتهي جميع الحروف
6. شاهد النتيجة النهائية

كيبورد الحروف

1. اضغط على أي حرف من الشبكة
2. اقرأ السؤال وأجب عليه
3. اضغط “تحقق من الإجابة”
4. الحرف سيختفي بعد الإجابة الصحيحة
5. استمر حتى تنتهي جميع الحروف

📁 هيكل المشروع

HarfChallengeKeyboardApp/
├── HarfChallengeKeyboardApp.swift    # الملف الرئيسي للتطبيق
├── Models/
│   └── GameQuestion.swift            # نموذج السؤال
├── ViewModels/
│   └── GameViewModel.swift           # منطق اللعبة
├── Resources/
│   └── questions.json               # الأسئلة السعودية
└── Info.plist                       # إعدادات التطبيق

🎯 الأسئلة السعودية

التطبيق يحتوي على أسئلة متنوعة عن:

• 🏙️ المدن السعودية: الرياض، مكة، الطائف، الدمام، الخبر، إلخ
• 🍽️ الأكلات الشعبية: كبسة، مظبي، حنيذ، ثريد، جريش، إلخ
• 🏔️ المواقع الجغرافية: جبل شمر، وادي خيبر، ذات عرق، إلخ
• 👥 القبائل السعودية: بني تميم، قحطان، مطير، عتيبة، إلخ

🔧 ملاحظات تقنية

• ✅ دعم RTL: التطبيق يدعم الكتابة من اليمين لليسار
• ✅ لا يحتاج إنترنت: جميع البيانات محلية
• ✅ متوافق مع Simulator: لا يحتاج جهاز حقيقي
• ✅ لا يحتاج توقيع: يعمل مباشرة على Simulator
• ✅ حجم صغير: محسن للتحميل السريع

🐛 استكشاف الأخطاء

إذا لم يعمل التطبيق:

1. تأكد من اختيار iOS Simulator
2. اضغط Cmd + Shift + K لتنظيف المشروع
3. اضغط Cmd + R لإعادة البناء
4. تأكد من أن Xcode محدث

إذا لم تظهر الأسئلة:

1. تأكد من وجود ملف questions.json في Resources
2. أعد تشغيل التطبيق
3. اضغط زر “إعادة اللعبة”

📞 الدعم

إذا واجهت أي مشاكل، تأكد من:

• استخدام Xcode محدث
• اختيار Simulator مناسب
• تنظيف وإعادة بناء المشروع

---

🇸🇦 تطبيق تعليمي سعودي - مصمم لتعلم الحروف العربية بطريقة ممتعة

كيبورد تحدي (KeyPlay)

لعبة تعليمية جماعية مستوحاة من تحدي الحروف السعودي، تدعم الفرق، لوحة مفاتيح سداسية، أسئلة عامة منوعة، مؤثرات صوتية وبصرية حديثة، وإدارة كاملة للأسئلة من داخل التطبيق.

المميزات الرئيسية

• لوحة مفاتيح سداسية تفاعلية مع توزيع عشوائي للحروف في كل جولة.
• أسئلة عامة (تاريخ، جغرافيا، فن، علوم…) لكل حرف، مع إجابات منطقية تبدأ بنفس الحرف.
• دعم الفرق (أحمر/أخضر) مع نظام نقاط ومسارات متصلة.
• مؤثرات بصرية (وميض، تدرج لوني، أنيميشن عند الفوز أو اختيار الحرف).
• مؤثرات صوتية للإجابة الصحيحة/الخاطئة/بدء اللعبة.
• تجربة أدمن متكاملة: إضافة/تعديل/حذف الأسئلة، بحث وترتيب، حماية بكلمة مرور.
• دعم كامل للويب وأندرويد وiOS (كل شيء محلي).

التشغيل

أندرويد/iOS

1. افتح المشروع في Android Studio أو VS Code.
2. شغل الأمر:

   flutter pub get
   flutter run
   

3. اختر الجهاز المناسب (محاكي أو هاتف).

الويب

1. تأكد من تحديث Flutter إلى آخر نسخة (3.24 أو أحدث).
2. شغل:

   flutter pub get
   flutter run -d chrome --web-renderer canvaskit
   

   أو لتجربة WASM:

   flutter run -d chrome --wasm
   

3. إذا واجهت مشاكل صوتية، جرب تحديث مكتبة audioplayers أو استخدم صيغة صوتية مختلفة (mp3/ogg/wav).

ملاحظات تقنية

• الصوتيات: audioplayers تعمل على الويب، لكن أحياناً تحتاج لتجربة أكثر من صيغة صوتية.
• التخزين: Hive يعمل على الويب، إذا ظهرت مشاكل في القيم الرقمية (int/double)، أضف معالجة تحويلية عند القراءة.
• الرسوميات: استخدم CanvasKit أو WASM، لأن HTML renderer سيتم إزالته في 2025.

تجربة الأدمن

• عند أول دخول، تظهر شاشة كلمة مرور (admin1212).
• بعد الدخول، تظهر خيارات الأدمن: بدء اللعبة، إضافة سؤال، تعديل الأسئلة (بحث، ترتيب، حذف، إبراز المعدل).
• كل شيء يتم حفظه محلياً (Hive).

المشاكل المعروفة

• بعض مشاكل الصوت على الويب (خاصة في WASM) قد تتطلب تحديث المكتبة أو تغيير الصيغة.
• مشاكل تحويل int/double في Hive على WASM: استخدم .toInt() أو .round() عند الحاجة.
• مشاكل الوصول (Accessibility) على الويب: راجع دليل Flutter الرسمي إذا كان جمهورك واسع.

للمساهمة أو الدعم

• الكود منظم ومعلق، ويمكن تطويره بسهولة.
• لأي استفسار أو اقتراح: تواصل مع المطور أو افتح Issue.

This site is open source. Improve this page.