Python#

У довіднику з API Python для VEX IQ (2-го покоління) пояснюється, що робить кожна команда, метод і функція, які вхідні дані вона використовує, що повертає та як її можна використовувати в проєкті.

Використовуйте цей посібник, коли хочете зрозуміти команду перед її додаванням до проєкту, перевірити, які значення вона приймає або повертає, або порівняти пов’язані команди в категорії.

Команди Python використовуються в проектах Python для VEXcode IQ (2-го покоління). Блоки та проекти C++ використовують інші розділи API.

Примітка: IQ (2-го покоління) Brain запускає Python через віртуальну машину з обмеженою пам’яттю. Хоча існує максимальний розмір вихідного коду, робота програми також залежить від її складності (наприклад, кількості функцій, змінних та логіки, що використовується). Як наслідок, великі або складні програми можуть не компілюватися або не запускатися, навіть якщо їх розмір менший за встановлений. Програми на C/C++ на IQ (2-го покоління) зазвичай менше зазнають впливу цих обмежень.

Як читати запис методу#

Більшість записів Python містять такі частини:

  • Назва команди – офіційна назва команди, методу або функції.

  • Опис – пояснює, що робить команда та коли вона корисна.

  • Використання – показує синтаксис, який використовується для запису команди в коді.

  • Параметри – Перелічує вхідні дані, які приймає команда, та пояснює, що робить кожен з них.

  • Повернене значення – пояснює, що повертає команда, якщо вона повертає значення.

  • Приклад коду – Показано один із способів використання команди в проєкті.

Загальні елементи API Python#

Елемент

Що це означає

Метод

Команда, що викликається для об’єкта, такого як drivetrain.drive(…).

Функція

Команда, що викликається безпосередньо, наприклад, wait(…) або print(…).

Параметр

Значення, що передається в метод або функцію для керування її діями.

Необов’язковий параметр

Параметр, який можна пропустити, щоб використовувати поведінку за замовчуванням.

Повернене значення

Значення, яке повертає команда, наприклад, число, текст або логічне значення.

Базовий словник Python#

Термін

Що це означає

Змінна

Ім’я, яке зберігає значення, наприклад, speed = 50.

Рядок

Текст у лапках, наприклад, “Hello”.

Ціле число

Додатне або від’ємне число, наприклад, 90.

Поплавок

Число з десятковим дробом, наприклад, 25.5.

Логічне значення

Значення, яке дорівнює True або False.

Суперечка

Значення, що передається у виклик методу або функції, наприклад, REVERSE in drivetrain.drive(REVERSE, 20, PERCENT).

Приклад введення методу#

диск#

drive переміщує робота вперед або назад безкінечно. Робот продовжуватиме рухатися, доки йому не буде надано іншу дію, таку як поворот або зупинка.

Usage:
drivetrain.drive(direction, velocity, units)

Параметри

Опис

direction

Напрямок руху робота: FORWARD або REVERSE.

velocity

Необов’язково. Швидкість руху від 0% до 100% при використанні PERCENT, від 0 до 120 об/хв при використанні RPMабо від 0 до 720 градусів за секунду при використанні VelocityUnits.DPSЦе може бути ціле число integerfloat). Якщо швидкість не вказана, робот рухається з поточною швидкістю приводу.

units

Необов’язково. Одиниця вимірювання швидкості: PERCENT (за замовчуванням), RPM (обертів за хвилину) або VelocityUnits.DPS (градусів за секунду).

 
# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()


# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()
On this page