RoboMasterPy: 大疆机甲大师的Python SDK和编程框架¶
版本 v0.1.1. (安装指南)
RoboMasterPy 是大疆机甲大师的Python SDK和编程框架:
Python SDK:遥测和控制机甲大师;
编程框架:提供和规范控制流和数据流,解决视频流拉取解析、事件和推送拉取解析等常见需求,解耦控制循环、日志打印、安全退出等模板代码,降低心智负担和劳动强度,让开发者可以专注于业务逻辑的实现。
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'
# 开启云台姿态推送,设定频率为5Hz,
# 推送可以使用RoboMasterPy编程框架进行获取和处理。
>>> cmd.gimbal_push_on(attitude_freq=5)
'ok'
# 当心飞弹!
>>> cmd.blaster_fire()
'ok'
框架让你能够更容易地创建复杂应用,例如:
用户指南¶
健康和安全警示¶
你的机甲大师可能会伤到人或者宠物,打破东西或者弄坏自己;
确保机甲大师有足够的行动空间,确保地面平整且没有障碍;
慢慢来,避免在调试代码时使用高速档位;
使用缓冲垫;
注意安全,玩的愉快!
致谢¶
RoboMasterPy是在机甲大师EP开发者比赛中孵化的,作者对DJI提供的硬件和技术支持表示感谢。
许可¶
RoboMasterPy 基于MIT许可发布, 您只需要保留署名和版权信息(LICENSE)即可自由使用本软件。