Différences entre AIM et WebSocket

Cette page décrit les principales différences entre l’API Python basée sur WebSocket et l’API Python VEXcode AIM. Elle présente les fonctionnalités ajoutées, les classes supprimées et la prise en charge de cas d’utilisation avancés tels que le contrôle de plusieurs robots.

Méthodes supplémentaires

lire_fichier_local

La méthode play_local_file permet de lire un fichier audio stocké sur l’ordinateur et de le diffuser via le haut-parleur du robot. Cela vous permet de lire des fichiers personnalisés .wav ou .mp3 le robot sans avoir à les télécharger.

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

Paramètres	Description
chemin d’accès	Une chaîne de caractères spécifiant le chemin d’accès à un fichier .wav ou .mp3 sur l’ordinateur.
volume	Optionnel. Le volume de lecture, exprimé en pourcentage (de 0 à 100). La valeur par défaut est 100.

Pour consulter un exemple d’implémentation, ouvrez play_sounds.py

obtenir_image_de_l’appareil_de_caméra

The get_camera_image method captures the current frame from the robot’s AI Vision Sensor and returns it as a JPEG-compressed bytes object. This is typically used with tools like OpenCV for displaying a live video feed.

Usage:
robot.vision.get_camera_image()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre

Pour voir un exemple d’implémentation, voir stream_video.py.

Utiliser plusieurs robots simultanément

Vous pouvez vous connecter à plusieurs robots en spécifiant manuellement l’adresse IP de chaque robot lors de la création d’objets Robot.

Usage:
Robot(address)

Paramètres	Description
adresse	Facultatif. Adresse IP du robot. Si elle est omise, l’adresse du champ host du settings.json est utilisée par défaut.

Pour voir un exemple d’implémentation, ouvrez multiple_robots.py.

Classes supprimées

Les classes suivantes, disponibles dans l’API Python de VEXcode, ne sont pas disponibles dans la version WebSocket :

• Controller

• Event

Fonctionnalités disponibles uniquement dans VEXcode

Les fonctionnalités suivantes ne sont actuellement pas prises en charge via l’API WebSocket d’AIM et nécessitent une connexion via VEXcode AIM :

• Mise à jour du micrologiciel du robot

• Téléchargement d’images personnalisées

• Téléchargement de sons personnalisés

• Messagerie de robot à robot