اختلافات بروتوكول WebSocket في AIM

توضح هذه الصفحة الاختلافات الرئيسية بين واجهة برمجة تطبيقات بايثون القائمة على WebSocket وواجهة برمجة تطبيقات VEXcode AIM بايثون. وتشمل هذه الاختلافات وظائف إضافية، وفئات محذوفة، ودعمًا لحالات استخدام متقدمة مثل التحكم في عدة روبوتات.

طرق إضافية

تشغيل الملف المحلي

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)

حدود	وصف
مسار الملف	سلسلة تحدد مسار ملف .wav أو .mp3 على الكمبيوتر.
مقدار	اختياري. مستوى صوت التشغيل كنسبة مئوية من 0 إلى 100. القيمة الافتراضية هي 100.

للاطلاع على مثال للتنفيذ، افتح play_sounds.py

get_camera_image

تقوم الدالة get_camera_image بالتقاط الإطار الحالي من مستشعر الرؤية المدعوم بالذكاء الاصطناعي الخاص بالروبوت، وتعيده ككائن مضغوط بصيغة JPEG بحجم bytes ويُستخدم هذا عادةً مع أدوات مثل OpenCV لعرض بث فيديو مباشر.

Usage:
robot.vision.get_camera_image()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات

للاطلاع على مثال للتنفيذ، انظر stream_video.py.

استخدام عدة روبوتات في وقت واحد

يمكنك الاتصال بالعديد من الروبوتات عن طريق تحديد عنوان IP لكل روبوت يدويًا عند إنشاء كائنات Robot.

Usage:
Robot(address)

حدود	وصف
عنوان	اختياري. عنوان IP الخاص بالروبوت. في حال عدم تحديده، يتم استخدام العنوان الموجود في حقل المضيف host settings.json.

للاطلاع على مثال للتنفيذ، افتح الملف multiple_robots.py.

الفئات المحذوفة

الفئات التالية المتوفرة في واجهة برمجة تطبيقات بايثون الخاصة بـ VEXcode غير متوفرة في إصدار WebSocket:

• Controller

• Event

ميزات متوفرة فقط في VEXcode

الميزات التالية غير مدعومة حاليًا عبر واجهة برمجة تطبيقات AIM WebSocket وتتطلب الاتصال من خلال VEXcode AIM:

• تحديث البرامج الثابتة للروبوت

• تحميل صور مخصصة

• تحميل أصوات مخصصة

• مراسلة الروبوتات لبعضها البعض