مكعبات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

محرك دوار لـ

يقوم محرك الدوران الخاص بوحدة التجميع بتدوير محرك أو مجموعة محركات لمسافة محددة. وتكون سرعة الدوران نسبيةً إلى الموضع الحالي للمحرك أو مجموعة المحركات. وينتظر البرنامج حتى ينتهي المحرك أو مجموعة المحركات من الدوران قبل تشغيل الوحدة التالية في التجميع.

أدر [Motor1 v] [للأمام v] بمقدار (90) [درجات v] ▶

حدود	وصف
محرك	المحرك أو مجموعة المحركات المراد تدويرها. اختر من بين المحركات المُهيأة في نافذة الأجهزة.
اتجاه	اتجاه دوران المحرك أو مجموعة المحركات. بشكل افتراضي، الخيارات هي للأمام وللخلف. يمكن أن تتغير خيارات الاتجاه حسب تكوين المحرك.
مسافة	المسافة التي يدورها المحرك أو مجموعة المحركات. الدرجات تُستخدم أعدادًا صحيحة. اللفات يمكن أن تُستخدم أعدادًا صحيحة أو عشرية.
وحدة	وحدة قياس المسافة: درجات أو دورات.
ولا تنتظر	حدد السهم ( ▶ ) لتوسيع الكتلة لتقول ولا تنتظر، حتى يتم تشغيل الكتلة التالية في المكدس على الفور.

مثال

عند البدء
[Spin the motor forward once, then reset.]
أدر [Motor1 v] [للأمام v] بمقدار (90) [درجات v] ▶
أدر [Motor1 v] [للخلف v] بمقدار (90) [درجات v] ▶