VICON Tracker بيثون API

تحديد

• اسم المنتج: Vicon Tracker بيثون API
• التوافق: متتبع 4.0
• إصدارات بايثون المدعومة: 2.7 وبيثون 3

تعليمات استخدام المنتج

قم بتثبيت واجهة برمجة تطبيقات Tracker

لاستخدام Tracker API مع Python، اتبع الخطوات التالية:

1. تحقق من إصدار Python للتأكد من التوافق.
2. قم بتثبيت Python عن طريق تنزيله من الموقع الرسمي webالموقع واختيار الإصدار المناسب.
3. حدد موقع وحدة Tracker Python وقم بتثبيتها من المجلد المحدد.

التحقق من إصدار بايثون

1. افتح موجه الأوامر.
2. اكتب "py" ثم اضغط على Enter.
3. إذا لم يتم تثبيت Python، فارجع إلى تعليمات التثبيت.

تثبيت بايثون

1. اذهب الى مسؤول بايثون webموقع.
2. قم بتنزيل Python وتثبيته، مع التأكد من إضافة python.exe إلى PATH أثناء التثبيت.

تثبيت وحدة Tracker Python:

1. حدد موقع التثبيت files في المجلد المحدد.
2. اختر طريقة التثبيت بناءً على الإعداد الخاص بك.

قم بتثبيت وحدة Python عن طريق تشغيل الدفعة File:

1. انتقل إلى مجلد تثبيت Python: C: Program FilesViconTracker4.xSDKPython
2. انقر نقرًا مزدوجًا فوق "install_tracker_api.bat" لبدء عملية التثبيت.

الأسئلة الشائعة:

س: ما الذي يمكنني تشغيله تلقائيًا باستخدام Tracker API؟

• A: تتيح لك Tracker API أتمتة الوظائف الشائعة مثل تحميل البيانات وتشغيلها وتصديرها وتنشيط/إلغاء تنشيط الكائنات وتشغيل أجزاء سير العمل.

س: ما هي إصدارات Python التي تدعمها Tracker API؟

• A: تدعم Tracker API إصدارات Python 2.7 وPython

حول هذا الدليل

• تتيح لك Tracker API التحكم في ميزات معينة في Tracker عبر Python API.
• تمكنك واجهة برمجة التطبيقات (API) من أتمتة بعض الوظائف الشائعة في Tracker، مثل تحميل البيانات وتشغيلها وتصديرها، أو تنشيط أو إلغاء تنشيط كائنات مختلفة، أو تشغيل أجزاء من سير العمل.
• يمكّنك هذا المستند من البدء باستخدام Tracker API.

قم بتثبيت واجهة برمجة تطبيقات Tracker

• لاستخدام Tracker API مع Python، يجب عليك التأكد من تثبيت كليهما.
• توفر Tracker API الدعم لـ Python 2.7 وPython 3. وتوصي Vicon باستخدام أحدث إصدار كامل من Python 3 ما لم يتطلب مشروعك منك استخدام إصدار محدد من Python.

ترشدك هذه الإجراءات خلال عملية التثبيت:

• تحقق من إصدار Python على
• تثبيت بايثون على
• تثبيت وحدة Tracker Python على
• تأكد من تثبيت وحدة Python بشكل صحيح

تحقق من إصدار بايثون

• إذا لم تكن متأكدًا من تثبيت Python أو إصدار Python الذي تستخدمه، فيمكنك فتح موجه الأوامر وتشغيل الأمر py.

على سبيل المثالampعلى:

إذا لم يكن Python مثبتًا لديك، فراجع تثبيت Python.

تثبيت بايثون لتثبيت بايثون 2 أو 3:

1. اذهب الى  https://www.python.org/downloads/
2. حدد موقع الإصدار المطلوب وقم بتثبيت Python، مع التأكد من تحديد Add python.exe to PATH:

في الصورة أعلاه، تم استبدال ABC باسم المستخدم الخاص بك لمجلد التثبيت.

تثبيت وحدة Tracker Python لتثبيت وحدة Tracker Python:

1. حدد موقع التثبيت fileس. إذا قمت بتثبيت Tracker في الموقع الافتراضي، فسيتم العثور عليه في هذا المجلد: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • هؤلاء fileيتم عرض ق:
2. قم بتثبيت وحدة Tracker Python بإحدى الطرق التالية، اعتمادًا على التثبيت الخاص بك:
   • إن أبسط طريقة هي تشغيل الدفعة file (install_tracker_api.bat) المضمن في تثبيت Tracker (كما هو موضح في الصورة أعلاه).
   • عادة ما يعمل هذا بشكل جيد إذا:
   • تم تثبيت بايثون على متغير PATH؛ أو
   • تم تثبيت إصدارات متعددة من Python، لكنك تريد تثبيت واجهة برمجة التطبيقات (API) على الإصدار الأحدث الذي قمت بتثبيته؛ أو
   • تم تثبيت إصدار واحد فقط من Python.
   • إذا انطبق أي من هذه الشروط، فراجع تثبيت وحدة python عن طريق تشغيل الدفعة file على.
   • في جميع الحالات الأخرى، قم بتثبيت وحدة بايثون باستخدام النقطة. ينطبق هذا عادةً إذا:
   • تم تثبيت إصدارات متعددة من Python، لكنك تريد التثبيت على إصدار محدد؛ أو
   • تم تثبيت عدة إصدارات مختلفة من Python وتريد تثبيتها جميعًا (في هذه الحالة، يجب عليك تثبيت الوحدة لكل إصدار)؛ أو
   • تم تثبيت إصدار واحد فقط من Python، ولكنك لم تقم بتثبيت PATH.
   • إذا انطبق أي من هذه الشروط، راجع تثبيت وحدة Python عن طريق تشغيل pip on.

قم بتثبيت وحدة Python عن طريق تشغيل الدفعة file للقيام بذلك:

1. انتقل إلى مجلد تثبيت بايثون: ج:\البرنامج Files\Vicon\Tracker4.x\SDK\Python
2. انقر نقرًا مزدوجًا فوق install_tracker_api.bat.
   • تتم تهيئة عملية التثبيت تلقائيًا.

قم بتثبيت وحدة Python عن طريق تشغيل النقطة

1. انتقل إلى مجلد البرامج النصية لـ Python الذي تريد استخدامه:
2. بالنسبة لـ Python 3، مجلد التثبيت الافتراضي هو: C: \Users\ \AppData\Local\Programs\Python\Python \Sc مزقت
   • بالنسبة لـ Python 2.7، مجلد التثبيت الافتراضي هو: C:\Python27\Scripts
3. افتح نافذة الأوامر أو PowerShell في هذا المجلد.
4. قم بتشغيل الأمر التالي لتثبيت Vicon Core API: C: \المستخدمين\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe تثبيت "C:\Program" Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • قم بتشغيل الأمر التالي لتثبيت Tracker API C: \المستخدمين\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe تثبيت "C:\Program" Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

ملحوظة المثال أعلاهampتستخدم البرامج تثبيت Python 3.11 مع Tracker 4.0. قد يختلف المسار والأوامر الخاصة بك قليلاً.

تأكد من تثبيت وحدة Python بشكل صحيح

• تأكد من تثبيت الوحدات التالية.
• vicon_core_api: هذه هي واجهة برمجة التطبيقات الأساسية للتحكم عن بعد وتتضمن عميلًا للاتصال بالخادم الطرفي.
• Tracker_api: واجهة برمجة تطبيقات الخدمات للوصول إلى وظائف التطبيق الخاصة بـ Tracker.
• لاختبار تثبيت وحدة Tracker Python بشكل صحيح، حاول استيراد إحدى الوحدات في Python: >>> import vicon_core_api

إذا فشلت العملية المذكورة أعلاه في التعرف على الوحدة، فجرب ما يلي:

• تحقق من مجلد حزم الموقع في تثبيت Python لمعرفة المجلد Tracker_api أو vicon_core_api. بالنسبة لـ Python 3.11، موقع مجلد التثبيت الافتراضي هو:
  • ج:\المستخدمين\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• تحقق من متغيرات بيئة النظام لديك وتأكد من أن مجلد البرامج النصية الخاص بتثبيت Python الذي تريد استخدامه هو الأعلى في القائمة. بالنسبة لـ Python 3.11، الموقع الافتراضي لمجلد التثبيت هو:
  • ج:\المستخدمين\ \AppData\Local\Programs\Python\Python311\Scripts
• إذا كان أي من مجلدات الوحدات مفقودًا، وقمت بالتحقق من المسار، فأعد التشغيل من خلال عملية التثبيت الموضحة في تثبيت وحدة Tracker Python on.

الاتصال بالخادم الطرفي

• للاتصال بالخادم الطرفي، قم أولاً باستيراد وحدة Vicon Core API: >>> import vicon_core_api
  • >>> من استيراد vicon_core_api
• بعد ذلك، قم بإنشاء عميل. يحاول هذا تلقائيًا الاتصال بعنوان المضيف المحدد على المنفذ الافتراضي (52800) >>> c = Client('localhost')
• تأكد من اتصال العميل بالخادم بنجاح: >>> طباعة(c.connected) صحيح
• إذا كانت الاستجابة خاطئة، فتأكد من أن لديك مثيل Tracker يعمل على عنوان المضيف المحدد وأن جدار الحماية الخاص بك لا يحظر حركة المرور على المنفذ 52800، قبل إنشاء عميل جديد.
• عند الاتصال بنجاح، يمكنك الوصول إلى الخدمات التي يوفرها خادم Tracker الطرفي.
• هذا السابقampيستخدم le خدمات الكائنات الأساسية: >>> استيراد Tracker_api >>> من Tracker_api استيراد BasicObjectServices >>> الخدمات = BasicObjectServices(c)
• عندما يكون متصلاً، يمكنك استدعاء الأساليب الموجودة على مثيل Tracker.
  • على سبيل المثالample، للحصول على قائمة بالكائنات في لوحة التتبع، استخدم: >>> result, object_list =services.basic_object_list() >>> print(result)
  • نعم: نجحت الوظيفة
  • >>> طباعة (object_list)
  • ['كائن 1'، 'كائن 2'...]
• تعرض جميع استدعاءات واجهة برمجة التطبيقات رمز النتيجة الموضح في vicon_core_api/result.py.
• أحد رموز الفشل المحتملة هو Result.RPCNotConnected، والذي يتم تلقيه في حالة فقدان الاتصال بالخادم الطرفي.
• على سبيل المثالampلو: >>> النتيجة، object_list = Services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: الاتصال بالوظيفة البعيدة أو رد الاتصال غير مفتوح
• لعرض قائمة بجميع الوظائف والوثائق المتاحة: >>> help(tracker_api)

Exampالبرامج النصية لو

• يمكنك العثور على السابقينampالبرامج النصية le توضح استخدام وظائف واجهة برمجة التطبيقات الشائعة في ج:\البرنامج Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• تحتوي جميع البرامج النصية على وثائق وتتخذ خيار المساعدة الذي يوفر تفاصيل عن الوسائط ذات الصلة.
• لتشغيل باسمample script، افتح نافذة الأوامر أو power shell في مجلد البرامج النصية أعلاه. يمكنك القيام بذلك بإحدى الطريقتين:
• افتح موجه الأوامر وقم بتغيير الدليل الخاص بك إلى مجلد البرامج النصية: ج:\> القرص المضغوط C:\البرنامج Files\Vicon\Tracker
  • 4.0\SDK\بايثون\sample_scripts
• اضغط مع الاستمرار على SHIFT + انقر بزر الماوس الأيمن في مجلد البرامج النصية وحدد فتح نافذة الأوامر هنا أو فتح نافذة Powershell هنا.
• من هنا يمكنك تشغيل السابقينampالبرنامج النصي الذي تختاره.
• المثال التاليampليه استخدام نافذة الأوامر.

Camera_calibration_wave.py

• يوضح هذا البرنامج النصي كيفية استخدام وظائف API للتحكم في عملية المعايرة لبدء وإيقاف موجة العصا.
  • ج:\البرنامج Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py Camera_calibration_wave.py
• في حالة النجاح، يتم عرض عناصر التحكم في المعايرة

Capture_control.py

• يوضح هذا البرنامج النصي كيفية التقاط البيانات المباشرة C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py Capture_control.py
• يتم إدراج اسم الالتقاط قبل عناصر التحكم. لتغيير اسم الالتقاط، استخدم Capture_services وSetCaptureName.
• للأسئلة حول استخدام Tracker API، اتصل بـ Vicon Support1.
• 1 ميلتو:support@vicon.com
• دليل البدء السريع لـ Vicon Tracker Python API 31 مايو 2023، المراجعة 1
• للاستخدام مع Tracker 4.0
• حقوق النشر © لعام 2020–2023 لشركة Vicon Motion Systems Limited. كل الحقوق محفوظة.
• المراجعة 1. للاستخدام مع Tracker 4.0
• تحتفظ شركة Vicon Motion Systems Limited بالحق في إجراء تغييرات على المعلومات أو المواصفات الواردة في هذا المستند دون إشعار.
• الشركات والأسماء والبيانات المستخدمة في السابقينampليه وهمية ما لم يذكر خلاف ذلك. لا يجوز إعادة إنتاج أي جزء من هذا المنشور أو تخزينه في نظام استرجاع أو نقله بأي شكل أو بأي وسيلة ، إلكترونية أو ميكانيكية ، عن طريق التصوير أو التسجيل ، أو بأي طريقة أخرى دون إذن كتابي مسبق من Vicon Motion Systems Ltd.
• Vicon® هي علامة تجارية مسجلة لشركة Oxford Metrics plc. Vicon Control™، Vicon Lock™، Vicon Lock Lab™، Vicon Lock Studio™، Vicon Tracker™، Vicon Valkyrie™، Vicon Vantage™، وVicon Vero™، وVicon Viper™، وVicon ViperX™، وVicon Vue™ هي علامات تجارية مملوكة لشركة Oxford Metrics plc.
• VESA® هي علامة تجارية مسجلة مملوكة لشركة VESA (www.vesa.org/about-vesa/). قد تكون أسماء المنتجات والشركات الأخرى الواردة هنا علامات تجارية لمالكيها المعنيين.
• للحصول على إقرارات كاملة ومحدثة بحقوق الطبع والنشر والعلامات التجارية، تفضل بزيارة https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems هي شركة تابعة لشركة Oxford Metrics plc.
• بريد إلكتروني: support@vicon.com Web: http://www.vicon.com

المستندات / الموارد

VICON Tracker بيثون API [بي دي اف] دليل المستخدم تعقب بايثون أبي، تعقب، بايثون أبي، أبي

مراجع

• دليل المستخدم