跳转到主要内容

Python 3的学生机器人API

项目描述

sr-robot3

Lint & build PyPI version Documentation Status MIT license Bees

sr-robot3 - 学生机器人套件Python 3 API

这是学生机器人的API,用于编写机器人API的库。它将首先在2024年学生机器人大会上部署。

安装

如果您希望从包管理器安装openCV,您可以使用以下命令安装基本包:

pip install sr-robot3

要安装完整包,包括openCV,您可以使用以下命令:

pip install sr-robot3[vision]

用法

API的主要入口点是Robot类。初始化此类将自动检测并连接到设备上连接的任何SR v4板。默认情况下,Robot类将在继续之前等待电源板上按下启动按钮。

from sr.robot3 import Robot

r = Robot()

要禁用等待启动按钮,您可以在构造函数中传递wait_for_start=False。在元数据可用之前,需要调用wait_for_start方法。

from sr.robot3 import Robot

r = Robot(wait_for_start=False)

# Setup in here

r.wait_start()

开发者注意

在设计此API时已经考虑了许多因素。其中一些可能不太明显,因此以下进行了记录。

  • API设计为在执行错误操作时引发异常,例如尝试修改输出字典或将值直接分配给电机对象。
  • 使用MappingProxyType来防止用户向API中返回字典的部分添加、删除或覆盖键。
  • 使用tuple来防止用户向API中返回列表的部分添加、删除或覆盖项目。
  • 使用__slots__来防止用户在API的任何部分添加、删除或覆盖属性。
  • sr.robot3.serial_wrapper.SerialWrapper处理串行端口连接丢失时的自动重连,并在引发BoardDisconnectionError之前在所有串行操作上实施3次重试。

项目详情


下载文件

下载您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

sr_robot3-2025.0.1.tar.gz (65.3 kB 查看哈希值)

上传时间

构建分布

sr_robot3-2025.0.1-py3-none-any.whl (52.7 kB 查看哈希值)

上传时间 Python 3

支持者