Python 3的学生机器人API
项目描述
sr-robot3
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 查看哈希值)
关闭
sr_robot3-2025.0.1.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | b815439e576fb3161055cd2b0185153fb3468b4221cea7a68c561ef75501c07d |
|
MD5 | 93cf6c209ea8a434746ec523a7584cde |
|
BLAKE2b-256 | 3ef457f2f9dc6009ce4afe20ba203cd6c2dcbbf22069380cddc5584c026ed110 |
关闭
sr_robot3-2025.0.1-py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | e2d3ba9016bb893506078a6662c28a592af494d0f7c313dbd74a6ffbe31fe315 |
|
MD5 | 19b9d29c6601ab7b294c18d63e3b6b7b |
|
BLAKE2b-256 | 4f3f92d456ff82556fd2355957adf65dff627943ed24d98ed9b748ba5e196f67 |