Python#

يشرح مرجع VEXcode VR Python API ما يفعله كل أمر وطريقة ووظيفة، وما هي المدخلات التي يستخدمها، وما الذي يعيده، وكيف يمكن استخدامه في مشروع.

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

تُستخدم أوامر بايثون في مشاريع VEXcode VR Python. أما مشاريع Blocks فتستخدم قسم Blocks API بدلاً من ذلك.

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

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

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

استخدم قسم الروبوتات للعثور على صفحات بايثون الخاصة بالروبوتات التي تحتوي على طرق فريدة. كما تُظهر صفحات الروبوتات بيئات التشغيل التي يُستخدم فيها كل روبوت، مما يُتيح لك معرفة متى تتوفر طريقة خاصة بالروبوت في مشروعك.

كيفية قراءة مدخلات الأسلوب#

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

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

عناصر واجهة برمجة تطبيقات بايثون الشائعة#

عنصر	ماذا يعني ذلك؟
طريقة	يتم استدعاء أمر على كائن مثل `drivetrain.rotation(…)`.
وظيفة	أمر يتم استدعاؤه مباشرة، مثل `wait(…)` أو `print(…)`.
المَعْلَمة	قيمة يتم تمريرها إلى طريقة أو دالة للتحكم في ما تفعله.
معامل اختياري	معلمة يمكن حذفها لاستخدام السلوك الافتراضي.
القيمة المُعادة	قيمة يُبلغ عنها الأمر، مثل رقم أو نص أو قيمة منطقية.

مفردات بايثون الأساسية#

شرط	ماذا يعني ذلك؟
عامل	اسم يخزن قيمة، مثل `angle = 90`.
خيط	النص الموجود داخل علامات الاقتباس، مثل `“Hello”`.
عدد صحيح	رقم موجب أو سالب، مثل `90`.
يطفو	رقم يحتوي على فاصلة عشرية، مثل `25.5`.
منطقي	قيمة إما `True` أو `False`.
دعوى	قيمة يتم تمريرها إلى طريقة أو استدعاء دالة، مثل `DEGREES` في `drivetrain.rotation(DEGREES)`.

مثال على إدخال الطريقة#

تناوب#

الدوران هو مقدار دوران الروبوت، ويُقاس بالدرجات. في بداية المشروع، تُضبط قيمة الدوران على صفر درجة. يُشير rotation إلى الدوران الحالي للروبوت.

يؤدي الانعطاف يمينًا إلى زيادة الدوران، بينما يؤدي الانعطاف يسارًا إلى تقليله. على سبيل المثال، يؤدي القيام بدورتين كاملتين إلى اليمين إلى دوران مقداره 720 درجة.

Usage:
drivetrain.rotation(units)

حدود	وصف
`units`	اختياري. وحدة الدوران: `DEGREES` (افتراضي).

def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)