مكعبات#

يشرح مرجع واجهة برمجة تطبيقات VEX IQ (الجيل الأول) Blocks ما يفعله كل كتلة VEXcode، وكيف تغير مدخلاتها سلوك الروبوت، وكيف يمكن استخدام الكتلة في مشروع.

استخدم هذا المرجع عندما تريد فهم كتلة قبل إضافتها إلى مشروع، أو التحقق مما تُبلغه الكتلة، أو مقارنة الكتل المتشابهة في فئة معينة.

تُستخدم الكتل في مشاريع VEXcode IQ Blocks. أما مشاريع C++ فتستخدم قسم واجهة برمجة التطبيقات النصية بدلاً من ذلك.

كيفية قراءة إدخال الكتلة#

تتضمن معظم إدخالات الكتل الأجزاء التالية:

وصف الكتلة - يشرح ما تفعله الكتلة ومتى تكون مفيدة.
صورة الكتلة - توضح شكل الكتلة في VEXcode IQ.
المعلمات - تسرد المدخلات الموجودة في الكتلة وتشرح كيف يؤثر كل مدخل على الروبوت أو المشروع.
قيمة الإرجاع - توضح ما الذي يبلغه كتلة Boolean أو Reporter.
مثال - يوضح إحدى الطرق التي يمكن بها استخدام الكتلة في مشروع ما.

أنواع الكتل الشائعة#

تختلف أشكال ووظائف الكتل المختلفة في المشروع.

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

مثال على إدخال كتلة#

يقود#

تقوم كتلة drive بتحريك الروبوت للأمام أو للخلف بشكل مستمر. سيستمر الروبوت في الحركة حتى يتم إعطاؤه إجراءً آخر، مثل الانعطاف أو التوقف.

تشغيل [للأمام v]

حدود	وصف
اتجاه	اتجاه حركة الروبوت: إلى الأمام أو إلى الخلف.

مثال

عند البدء
[Drive forward, then stop.]
تشغيل [للأمام v]
انتظر (2) ثانية
إيقاف القيادة