Python#

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

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

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

Команди Python у VEXcode VR можуть залежати від ігрового майданчика та робота, якого ви використовуєте. Деякі роботи містять унікальні методи, які не з’являються в кожному ігровому майданчику.

Дитячі майданчики та роботи у віртуальній реальності#

Скористайтеся розділом Ігрові майданчики, щоб побачити, який робот використовується на кожному ігровому майданчику, а також знайти деталі налаштування, інформацію про поле та контекст завдання, що стосуються конкретного ігрового майданчика.

Використовуйте розділ Robots, щоб знайти сторінки Python, специфічні для роботів, з унікальними методами. Сторінки Robots також показують, на яких ігрових майданчиках використовується кожен робот, тож ви можете визначити, коли у вашому проєкті доступний специфічний для робота метод.

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

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

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

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

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

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

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

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

обертання#

Обертання – це кут повороту робота, виміряний у градусах. На початку проекту значення повороту встановлюється на 0 градусів. 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)