Python

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

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

Команди Python використовуються в проектах VEXcode AIR Python. Проекти Blocks використовують розділ Blocks API.

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

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

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

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

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

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

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

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

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

Елемент	Що це означає
Метод	Команда, що викликається для об’єкта, такого як drone.take_off(…).
Функція	Команда, що викликається безпосередньо, наприклад, wait(…) або print(…).
Параметр	Значення, що передається в метод або функцію для керування її діями.
Необов’язковий параметр	Параметр, який можна пропустити, щоб використовувати поведінку за замовчуванням.
Повернене значення	Значення, яке повертає команда, наприклад, число, текст або логічне значення.

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

Термін	Що це означає
Змінна	Ім’я, яке зберігає значення, наприклад, height = 500.
Рядок	Текст у лапках, наприклад, “Hello”.
Ціле число	Додатне або від’ємне число, наприклад, 90.
Поплавок	Число з десятковим дробом, наприклад, 25.5.
Логічне значення	Значення, яке дорівнює True або False.
Суперечка	Значення, що передається у виклик методу або функції, наприклад, 500 з drone.take_off(climb_to=500).

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

зліт

take_off запускає пропелери та піднімає дрон у повітря. Цей метод необхідно використовувати до того, як можна буде виконувати інші рухи.

Використання:

drone.take_off(climb_to, units, wait)

Параметри	Опис
climb_to	Z-позиція, до якої летітиме дрон.
units	Одиниці вимірювання: CM - Сантиметри MM - Міліметри INCHES
wait	Необов’язково. wait=True (за замовчуванням) - Дрон чекає завершення take_off перед виконанням наступного рядка коду. wait=False - Дрон починає дію та одразу переходить до наступного рядка коду, не чекаючи завершення take_off

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()