AIM WebSocket 差异#

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

其他方法#

play_local_file#

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

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

参数

描述

filepath

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

volume

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

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

get_camera_image#

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

Usage:
robot.vision.get_camera_image()

参数

描述

此方法没有参数

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

同时使用多个机器人#

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

Usage:
Robot(address)

参数

描述

address

可选。机器人的 IP 地址。如果省略,则默认使用 hostsettings.json 中的地址。

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

已删除的类#

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

  • Controller

  • Event

仅在 VEXcode 中可用的功能#

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

  • 更新机器人固件

  • 上传自定义图像

  • 上传自定义声音

  • 机器人间通信