AIM WebSocket 差异#

本页概述了基于 WebSocket 的 Python API 与 VEXcode AIM Python API 之间的主要区别。其中包括新增的功能、移除的类以及对多机器人控制等高级用例的支持。

其他方法#

播放本地文件#

play_local_file 方法播放存储在计算机上的声音文件,并通过机器人的扬声器输出。这允许您在机器人上播放自定义的 .wav.mp3 文件,而无需上传它们。

用法:
robot.sound.play_local_file(filepath: str,volume = 100)

参数

描述

文件路径

指定计算机上“.wav”或“.mp3”文件的路径的字符串。

体积

可选。播放音量百分比,范围为 0 到 100。默认值为 100。

要查看实现示例,请打开“play_sounds.py”

获取相机图像#

get_camera_image 方法从机器人的 AI 视觉传感器捕获当前帧,并将其作为 JPEG 压缩的 bytes 对象返回。这通常与 OpenCV 等工具一起使用,用于显示实时视频。

用法:
robot.vision.get_camera_image()

参数

描述

此方法没有参数

要查看实现示例,请参阅“stream_video.py”。

同时使用多个机器人#

您可以通过在创建“Robot”对象时手动指定每个机器人的 IP 地址来连接到多个机器人。

用法:
机器人(地址)

参数

描述

地址

可选。机器人的 IP 地址。如果省略,则默认使用 settings.jsonhost 字段的 IP 地址。

要查看实现示例,请打开“multiple_robots.py”。

已删除的类#

VEXcode Python API 中提供的以下类在 WebSocket 版本中不可用:

  • 控制器

  • 事件

仅在 VEXcode 中可用的功能#

以下功能目前不支持通过 AIM WebSocket API 使用,需要通过 VEXcode AIM 连接:

  • 更新机器人固件

  • 上传自定义图像

  • 上传自定义声音

  • Robot to robot messaging