RoboMasterPy — это Python SDK и программируемый фреймворк от DJI RoboMaster.

SDK (клиент) используется следующим образом:

>>> import robomasterpy as rm

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

# Получение API версии прошивки робота-мастера
>>> cmd.version()
'version 00.00.00.60'

>>> cmd.get_robot_mode()
'chassis_lead'

# Выполнение команды возможно только после того, как вы убедитесь, что у робота-мастера достаточно места для манёвра
>>> cmd.chassis_move(x=-1, z=30)
'ok'

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

# Активация отправки данных о положении стабилизатора, установка частоты 5 Гц,
# данные об отправке можно получить и обработать с помощью программируемого фреймфорка RoboMasterPy
>>> 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/zh_CN/latest/

Документация представлена на китайском и английском языках.

Read the Docs предоставляет услуги хостинга документации.

Меры предосторожности

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

Юридические вопросы

RoboMasterPy — это любительское произведение, не связанное с DJI.

DJI, RoboMaster и Big Dipper являются торговыми марками Shenzhen Da Jiang Innovations Technology Co., Ltd.

Благодарности

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

Лицензия

RoboMasterPy выпущен под лицензией MIT. Вы можете свободно использовать это программное обеспечение, сохранив информацию об авторских правах и лицензии (LICENSE).