RoboMasterPy

RoboMasterPy — это Python SDK и фреймворк RoboMaster:

• Python SDK позволяет удалённо проверять и контролировать RoboMaster;
• Фреймворк предоставляет структуру для разработки, регулирует поток управления и данных, решает общие задачи, такие как получение и анализ видеопотока, событий и обновлений, а также разделяет повторяющийся код, например, управление циклом, логирование и корректное завершение работы. Вы можете положиться на фреймворк, легко реализовать свою бизнес-логику и сократить ручной труд. SDK (клиент) прост в использовании:

>>> import robomasterpy as rm

# IP RoboMaster определяется в режиме маршрутизатора
>>> cmd = rm.Commander()

# проверка версии API RoboMaster
>>> cmd.version()
'версия 00.00.00.60'

>>> cmd.get_robot_mode()
'chassis_lead'

# убедитесь, что у вашего RoboMaster достаточно места для движения
>>> cmd.chassis_move(x=-1, z=30)
'ok'

# активируйте потоковую передачу видео,
# которая может быть обработана фреймворком.
>>> cmd.stream(rm.SWITCH_ON)
'ok'

# включите отправку данных об ориентации кардана с частотой 5 Гц,
# которая может обрабатываться фреймворком.
>>> cmd.gimbal_push_on(attitude_freq=5)
'ok'

# Будьте осторожны!
>>> cmd.blaster_fire()
'ok'

Фреймворк позволяет создавать сложные приложения проще, например:

• управлять роботом с помощью клавиатуры;
• сделать робота вратарём;
• больше примеров.

Установка

RoboMasterPy требует Python 3.6 и выше.

Сначала установите зависимости

Если вы используете Python 3.6.x, вам необходимо установить dataclasses, который уже включён в Python 3.7 и более поздних версиях:

pip install dataclasses

Установите OpenCV по своему вкусу, рекомендуется:

# если вы используете conda
conda install -c conda-forge opencv

# если вы используете только pip
pip install opencv-contrib-python

Установите RoboMasterPy

pip install robomasterpy

Руководство пользователя

• Английский: https://robomasterpy.nanmu.me/en/latest/
• 中文文档（Chinese）：https://robomasterpy.nanmu.me/zh_CN/latest/ Документация любезно размещена на Read the Docs.

Уведомление о безопасности

• Ваш RoboMaster может причинить вред людям или домашним животным, сломать вещи или себя;
• Убедитесь, что у вашего RoboMaster достаточно места для перемещения; убедитесь, что земля чистая;
• Начинайте медленно, избегайте использования высокой скорости для отладки;
• Используйте подушку;
• Будьте осторожны и получайте удовольствие!

Документация

RoboMasterPy — это фанатская работа, не связанная с DJI. DJI, RoboMaster являются торговыми марками SZ DJI Technology Co., Ltd.

Признание

RoboMasterPy был разработан во время конкурса по разработке EP RoboMaster. Автор хотел бы поблагодарить DJI за оборудование и техническую поддержку.

Лицензия

Лицензия MIT Авторские права (c) 2020 LI Zhennan