إشعار

يحتوي هذا المستودع على FTC SDK العام لموسم مسابقة SKYSTONE (2019-2020).

كان هذا المشروع البرمجي مستضافًا سابقًا هنا. الفرق التي تتنافس في تحدي SKYSTONE يجب أن تستخدم هذا المستودع الجديد لـ SKYSTONE بدلاً من المستودع القديم ftc_app (الذي لم يعد يتم تحديثه).

مرحباً!

يحتوي مستودع GitHub هذا على الكود المصدري المستخدم لبناء تطبيق Android للتحكم في روبوت مسابقة FIRST Tech Challenge. لاستخدام SDK هذا، قم بتنزيل/استنساخ المشروع بأكمله إلى جهاز الكمبيوتر المحلي الخاص بك.

البدء

إذا كنت جديدًا في مجال الروبوتات أو جديدًا في FIRST Tech Challenge، فيجب عليك التفكير في مراجعة دروس FTC Blocks للتعرف على كيفية استخدام نظام التحكم:

      دروس FTC Blocks عبر الإنترنت

حتى لو كنت مبرمج Java متقدمًا، فمن المفيد البدء بـ دروس FTC Blocks، ثم الانتقال إلى أداة OnBot Java أو إلى Android Studio بعد ذلك.

تنزيل المشروع

إذا كنت مبرمج Android Studio، فهناك عدة طرق لتنزيل هذا المستودع. لاحظ أنه إذا كنت تستخدم Blocks أو أداة OnBot Java لبرمجة الروبوت الخاص بك، فلن تحتاج إلى تنزيل هذا المستودع.

• إذا كنت مستخدم git، يمكنك استنساخ أحدث إصدار من المستودع:

            git clone https://github.com/FIRST-Tech-Challenge/SKYSTONE.git

• أو، إذا كنت تفضل، يمكنك استخدام زر "Download Zip" المتاح من صفحة المستودع الرئيسية. تنزيل المشروع كملف .ZIP سيبقي حجم التنزيل معقولاً.

• يمكنك أيضًا تنزيل مجلد المشروع (كملف أرشيف .zip أو .tar.gz) من قسم التنزيلات في صفحة Releases لهذا المستودع.

بمجرد تنزيل مجلدك وفك ضغطه (إذا لزم الأمر)، يمكنك استخدام Android Studio لاستيراد المجلد ("Import project (Eclipse ADT, Gradle, etc.)").

الحصول على المساعدة

وثائق المستخدم والدروس

تحتفظ FIRST بوثائق عبر الإنترنت تحتوي على معلومات ودروس حول كيفية استخدام برنامج FIRST Tech Challenge ونظام التحكم في الروبوت. يمكنك الوصول إلى هذه الوثائق باستخدام الرابط التالي:

      وثائق SKYSTONE عبر الإنترنت

لاحظ أن الوثائق عبر الإنترنت هي مستند "دائم التحديث" يتم تحديثه وتحريره باستمرار. يحتوي على أحدث المعلومات حول برنامج FIRST Tech Challenge ونظام التحكم.

المواد المرجعية لـ Javadoc

وثائق مرجع Javadoc لـ FTC SDK متاحة الآن عبر الإنترنت. انقر على الرابط التالي لعرض وثائق FTC SDK Javadoc كموقع ويب مباشر:

      وثائق FTC Javadoc

وثائق FTC SDK مضمنة أيضًا في هذا المستودع. يوجد مجلد فرعي يسمى "doc" يحتوي على عدة مجلدات فرعية:

• المجلد "apk" يحتوي على ملفات .apk لتطبيقات FTC Driver Station و FTC Robot Controller.
• المجلد "javadoc" يحتوي على وثائق JavaDoc للمستخدم الخاصة بـ FTC SDK.

منتدى المستخدمين عبر الإنترنت

للأسئلة الفنية المتعلقة بنظام التحكم أو FTC SDK، يرجى زيارة منتدى FTC Technology:

      منتدى FTC Technology

---

معلومات الإصدار

---

الإصدار 5.2 (20190905-083227)

• يصلح الهوامش الواسعة جدًا في أنشطة الإعدادات، وموضع زر التكوين الجديد
• يضيف بيانات هدف صورة Skystone Vuforia.
  • يتضمن أوضاع تشغيل نموذجية لـ Skystone Vuforia Navigation (Java).
  • يتضمن أوضاع تشغيل نموذجية لـ Skystone Vuforia Navigation (Blocks).
• يضيف نموذج استدلال TensorFlow (.tflite) لعناصر لعبة Skystone.
  • يتضمن أوضاع تشغيل نموذجية لـ Skystone TensorFlow (Java).
  • يتضمن أوضاع تشغيل نموذجية لـ Skystone TensorFlow (Blocks).
• يزيل أوضاع التشغيل النموذجية القديمة (الخاصة بالموسم).
• يتضمن دعم 64 بت (للامتثال لمتطلبات Google Play).
• يحمي من تعليق أوضاع التشغيل عند طلب إعادة تشغيل الروبوت. (شكرًا لـ FROGbots-4634) (مشكلة ftc_app #709)
• تغييرات متعلقة بـ Blocks:
  • يصلح خطأ في الكود المولد بواسطة blocks عندما يكون اسم جهاز الأجهزة كلمة محجوزة في Java أو JavaScript.
  • يعرض كود جافا المولد لـ blocks، حتى عندما تكون عناصر الأجهزة مفقودة من التكوين النشط.
  • يعرض أيقونة تحذير عند استخدام blocks قديمة لـ Vuforia و TensorFlow (مشكلة SkyStone #27)

---

معلومات الإصدار

---

الإصدار 5.1 (20190820-222104)

• يحدد معلمات PIDF الافتراضية للمحركات التالية:
  • محرك REV Core Hex
  • محرك REV 20:1 HD Hex
  • محرك REV 40:1 HD Hex
• يضيف زر الرجوع عند التشغيل على جهاز بدون زر رجوع نظام (مثل Control Hub)
• يسمح لـ REV Control Hub بتحديث البرنامج الثابت على REV Expansion Hub عبر USB
• يصلح مشكلة SkyStone #9
• يصلح مشكلة ftc_app #715
• يمنع النقرات الإضافية لمستخدم DS عن طريق التصفية بناءً على الحالة الحالية.
• يمنع تغييرات حالة واجهة مستخدم DS غير الصحيحة عند استلام قائمة OpMode جديدة من RC
• يضيف دعمًا لمستشعر الألوان REV V3
• يضيف دفق كاميرا DS بتحديث يدوي لعرض إطارات كاميرا RC عن بعد.
  • لعرض الدفق على DS، قم بتهيئة ولكن لا تقم بتشغيل وضع تشغيل ممكّن للدفق، واختر خيار Camera Stream في قائمة DS، ثم انقر على الصورة للتحديث. هذه الميزة ممكّنة تلقائيًا عند استخدام Vuforia أو TFOD - لا يلزم تكوين إضافي لـ RC في حالات الاستخدام النموذجية. لإخفاء الدفق، اختر نفس عنصر القائمة مرة أخرى.
  • لاحظ أن لوحات الألعاب معطلة ولا يمكن بدء وضع التشغيل المحدد أثناء فتح الدفق كإجراء احترازي للسلامة.
  • لاستخدام الدفق المخصص، راجع وثائق API لـ CameraStreamServer#setSource و CameraStreamSource.
• يضيف العديد من أصوات Star Wars إلى موارد RobotController.
• أضاف برنامجًا نموذجيًا لاختيار أصوات SKYSTONE.
• يستبدل أصوات بدء التشغيل والاتصال والخطأ/التحذير بأصوات Star Wars
• يحدث OnBot Java لاستخدام WebSocket للاتصال بالروبوت
  • لم يعد على صفحة OnBot Java القيام بتحديث كامل عندما ينتقل المستخدم من تحرير ملف إلى آخر

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

• دفق الكاميرا
  • يعاني دفق كاميرا Vuforia من المشكلات الموجودة في معاينة الهاتف (أي مشكلة ftc_app #574). هذه المشكلة لا تؤثر على دفق كاميرا TFOD على الرغم من أنه يتلقى إطارات من Vuforia.
  • قد لا يتطابق اتجاه إطارات الدفق دائمًا مع معاينة الهاتف. في الوقت الحالي، يمكن تدوير هذه الإطارات يدويًا عبر CameraStreamSource مخصص إذا رغبت في ذلك.
• OnBotJava
  • قد لا يعمل زر الرجوع في المتصفح بشكل صحيح دائمًا
  • من الممكن أن يتم وضع بناء في قائمة الانتظار، ولكن لا يبدأ. ستظهر وحدة تحكم بناء OnBot Java تحذيرًا في حالة حدوث ذلك.
  • قد لا يدرك المستخدم أنه يقوم بتحرير ملف مختلف إذا انتقل عن غير قصد من ملف إلى آخر لأن هذا الانتقال أصبح سلسًا الآن. يتم عرض اسم الملف المفتوح حاليًا في علامة تبويب المتصفح.

---

معلومات الإصدار

---

الإصدار 5.0 (built on 19.06.14)