مكعبات

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

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

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

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

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

• وصف الكتلة - يشرح ما تفعله الكتلة ومتى تكون مفيدة.

• صورة الكتلة - توضح شكل الكتلة في VEXcode AIM.

• المعلمات - تسرد المدخلات الموجودة في الكتلة وتشرح كيف يؤثر كل مدخل على الروبوت أو المشروع.

• قيمة الإرجاع - توضح ما الذي يبلغه كتلة Boolean أو Reporter.

• مثال - يوضح إحدى الطرق التي يمكن بها استخدام الكتلة في مشروع ما.

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

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

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

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

يتحرك

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

تحريك كتلة المكدس للأمام

تحرك [للأمام v]

حدود	وصف
اتجاه	اتجاه حركة الروبوت: للأمام للخلف لليسار لليمين

مثال

عند البدء، انطلق للأمام

عند البدء
[Move forward]
تحرك [للأمام v]