مكعبات#

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

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

تختلف أنواع الكتل في VEXcode VR باختلاف ساحة اللعب والروبوت المستخدم. بعض الروبوتات تتضمن كتلًا فريدة لا تظهر في جميع ساحات اللعب.

الملاعب والروبوتات في الواقع الافتراضي#

استخدم قسم الملاعب لمعرفة الروبوت المستخدم في كل ملعب وللعثور على تفاصيل الإعداد الخاصة بالملعب ومعلومات الميدان وسياق التحدي.

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

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

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

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

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

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

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

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

يقود#

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

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

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

مثال

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