AIM WebSocket 的區別#

本頁面概述了基於 WebSocket 的 Python API 和 VEXcode AIM Python API 之間的主要差異。其中包括新增功能、移除的類別以及高階用例(例如多機器人控制)的支援。

其他方法#

播放本地文件#

play_local_file 方法播放儲存在電腦上的聲音文件,並透過機器人的揚聲器輸出聲音。這樣,您就可以在機器人上播放自訂的 .wav 或 .mp3 而無需上傳它們。

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

參數

描述

文件路徑

指定電腦上 .wav 或 .mp3 檔案的路徑的字串。

體積

可選。播放音量,以百分比表示,範圍為 0 到 100。預設值為 100。

若要查看實作範例,請開啟 play_sounds.py

取得相機影像#

get_camera_image 方法從機器人的 AI 視覺感測器捕獲當前幀,並將其作為 JPEG 壓縮的 bytes 組物件返回。這通常與 OpenCV 等工具配合使用,用於顯示即時視訊串流。

Usage:
robot.vision.get_camera_image()

參數

描述

此方法沒有參數

若要查看實作範例,請參閱 stream_video.py。

同時使用多個機器人#

建立 Robot 物件時,可以透過手動指定每個機器人的 IP 位址來連接到多個機器人。

Usage:
Robot(address)

參數

描述

地址

可選。機器人的 IP 位址。如果省略,則預設使用 settings.json 行 列的 host 欄位中的位址。

若要查看實作範例,請開啟 multiple_robots.py。

已移除的課程#

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

  • Controller

  • Event

VEXcode 獨有功能#

以下功能目前不支援透過 AIM WebSocket API 實現,需要透過 VEXcode AIM 連線:

  • 更新機器人韌體

  • 上傳自訂圖片

  • 上傳自訂聲音

  • 機器人間通信