AIM WebSocket-Unterschiede

Diese Seite beschreibt die wichtigsten Unterschiede zwischen der WebSocket-basierten Python-API und der VEXcode AIM Python-API. Sie umfasst hinzugefügte Funktionen, entfernte Klassen und die Unterstützung für fortgeschrittene Anwendungsfälle wie die Steuerung mehrerer Roboter.

Zusätzliche Methoden

play_local_file

The play_local_file method plays a sound file that is stored on the computer and outputs the sound through the robot’s speaker. This allows you to play custom .wav or .mp3 files on the robot without needing to upload them.

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

Parameter	Beschreibung
Dateipfad	Eine Zeichenkette, die den Pfad zu einer .wav oder .mp3 Datei auf dem Computer angibt.
Volumen	Optional. Die Wiedergabelautstärke in Prozent (0 bis 100). Standardwert: 100.

Um ein Implementierungsbeispiel anzuzeigen, öffnen Sie play_sounds.py

get_camera_image

Die Methode get_camera_image erfasst das aktuelle Bild des KI-Vision-Sensors des Roboters und gibt es als JPEG-komprimiertes Objekt bytes zurück. Dies wird typischerweise mit Tools wie OpenCV zur Anzeige eines Live-Videostreams verwendet.

Usage:
robot.vision.get_camera_image()

Parameter	Beschreibung
	Diese Methode hat keine Parameter

Ein Implementierungsbeispiel finden Sie unter stream_video.py.

Mehrere Roboter gleichzeitig einsetzen

Sie können mehrere Roboter verbinden, indem Sie beim Erstellen von Robot Objekten die IP-Adresse jedes Roboters manuell angeben.

Usage:
Robot(address)

Parameter	Beschreibung
Adresse	Optional. Die IP-Adresse des Roboters. Wird diese weggelassen, wird standardmäßig die Adresse im Feld host der settings.json verwendet.

Um ein Implementierungsbeispiel anzuzeigen, öffnen Sie multiple_robots.py.

Entfernte Klassen

Die folgenden in der VEXcode Python API verfügbaren Klassen sind in der WebSocket-Version nicht verfügbar:

• Controller

• Event

Funktionen, die nur in VEXcode verfügbar sind

Die folgenden Funktionen werden derzeit über die AIM WebSocket API nicht unterstützt und erfordern eine Verbindung über VEXcode AIM:

• Aktualisierung der Roboter-Firmware

• Hochladen benutzerdefinierter Bilder

• Hochladen von benutzerdefinierten Sounds

• Roboter-zu-Roboter-Kommunikation