Python#

Справочник по API Python для VEXcode VR объясняет, что делает каждая команда, метод и функция, какие входные данные они используют, что возвращают и как их можно использовать в проекте.

Используйте этот справочник, если хотите понять, что представляет собой команда, прежде чем добавлять её в проект, проверить, какие значения она принимает или возвращает, или сравнить связанные команды в категории.

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

Команды Python в VEXcode VR могут зависеть от используемой вами платформы Playground и робота. Некоторые роботы имеют уникальные методы, которые отсутствуют на каждой платформе Playground.

Детские площадки и роботы в виртуальной реальности#

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

Используйте раздел Роботы, чтобы найти страницы Python, посвященные конкретным роботам с уникальными методами. На страницах «Роботы» также указано, в каких средах Playground используется каждый робот, поэтому вы можете определить, когда метод, специфичный для робота, доступен в вашем проекте.

Как читать описание метода ввода#

Большинство статей по 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)
На этой странице