VICON Tracker Python API

مشخصات

• د محصول نوم: Vicon Tracker Python API
• مطابقت: ټریکر 4.0
• د Python ملاتړ شوي نسخې: 2.7 او Python 3

د محصول کارولو لارښوونې

د Tracker API نصب کړئ

د Python سره د Tracker API کارولو لپاره، دا ګامونه تعقیب کړئ:

1. د مطابقت ډاډ ترلاسه کولو لپاره د Python نسخه چیک کړئ.
2. Python د رسمي څخه ډاونلوډ کولو سره نصب کړئ webسایټ او مناسب نسخه غوره کول.
3. د ټاکل شوي فولډر څخه د Tracker Python ماډل ومومئ او نصب کړئ.

د Python نسخه چیک کړئ

1. د کمانډ پرامپټ خلاص کړئ.
2. 'py' ټایپ کړئ او Enter فشار ورکړئ.
3. که Python نصب شوی نه وي، د نصبولو لارښوونو ته مراجعه وکړئ.

Python نصب کړئ

1. ورتګ د Python رسمي webسایټ.
2. Python ډاونلوډ او نصب کړئ، ډاډ ترلاسه کړئ چې د نصب کولو پرمهال PATH ته python.exe اضافه کړئ.

د Tracker Python ماډل نصب کړئ:

1. نصب کول ومومئ files په ټاکل شوي فولډر کې.
2. ستاسو د تنظیم کولو پراساس د نصب کولو میتود غوره کړئ.

د بیچ په چلولو سره د پایتون ماډل نصب کړئ File:

1. د Python install فولډر ته لاړ شئ: C: برنامه FilesViconTracker4.xSDKPython
2. د نصبولو پروسې پیل کولو لپاره 'install_tracker_api.bat' باندې دوه ځله کلیک وکړئ.

په مکرر ډول پوښتل شوي پوښتنې (FAQ):

پوښتنه: زه د Tracker API په کارولو سره څه اتومات کولی شم؟

• A: د ټریکر API تاسو ته اجازه درکوي عام افعال اتومات کړئ لکه بار کول ، لوبې کول ، د ډیټا صادرول ، د شیانو فعالول / غیر فعال کول ، او د کاري فلو برخو محرک کول.

پوښتنه: د Python کومې نسخې د Tracker API لخوا ملاتړ کیږي؟

• A: Tracker API د Python نسخو 2.7 او Python ملاتړ کوي

د دې لارښود په اړه

• د Tracker API تاسو ته اجازه درکوي د Python API له لارې د ټریکر ځینې ځانګړتیاوې کنټرول کړئ.
• API تاسو ته وړتیا درکوي د ټریکر ځینې عام دندې اتومات کړئ ، لکه د ډیټا بار کول ، لوبې کول او صادرول ، د مختلف شیانو فعالول یا غیر فعال کول ، یا د کاري فلو برخې محرک کول.
• دا سند تاسو ته وړتیا درکوي چې د Tracker API سره پیل وکړئ.

د Tracker API نصب کړئ

• د Python سره د Tracker API کارولو لپاره، تاسو باید ډاډ ترلاسه کړئ چې تاسو دواړه نصب کړي.
• Tracker API د Python 2.7 او Python 3 لپاره ملاتړ چمتو کوي. Vicon وړاندیز کوي چې تاسو د Python 3 وروستی بشپړ ریلیز وکاروئ پرته لدې چې ستاسو پروژه تاسو ته د Python ځانګړې نسخه کارولو ته اړتیا ولري.

دا کړنالرې تاسو ته د نصب کولو پروسې له لارې لارښوونه کوي:

• د Python نسخه وګورئ
• د Python نصب کول
• د Tracker Python ماډل نصب کول
• وګورئ چې د Python ماډل په سمه توګه نصب شوی

د Python نسخه چیک کړئ

• که تاسو ډاډه نه یاست چې تاسو Python نصب کړی یا د Python کومه نسخه تاسو کاروئ، تاسو کولی شئ د کمانډ پرامپټ پرانیزئ او د py کمانډ پرمخ وړئ.

د مثال لپارهampLe:

که تاسو Python نصب نه کړئ، وګورئ Python نصب کړئ.

Python نصب کړئ د Python 2 یا 3 نصبولو لپاره:

1. ورتګ  https://www.python.org/downloads/
2. اړین نسخه ومومئ او Python نصب کړئ، ډاډ ترلاسه کړئ چې PATH ته python.exe اضافه کړئ غوره شوی:

په پورتني عکس کې، ABC د نصب کولو فولډر لپاره ستاسو د کارونکي نوم سره بدل شوی.

د Tracker Python ماډل نصبولو لپاره د Tracker Python ماډل نصب کړئ:

1. نصب کول ومومئ files. که تاسو په ډیفالټ ځای کې ټریکر نصب کړی ، دوی پدې فولډر کې موندل کیږي: C:\پروګرام Files\Vicon\Tracker4.x\SDK\Python
   • دا files ښودل شوي:
2. د Tracker Python ماډل په لاندې لارو کې نصب کړئ، ستاسو په ځانګړي نصب پورې اړه لري:
   • ترټولو ساده لاره د بسته بندۍ چلول دي file (install_tracker_api.bat) چې د ټریکر نصب کې شامل دی (لکه څنګه چې په پورتني عکس کې ښودل شوي).
   • دا معمولا ښه کار کوي که:
   • Python د PATH متغیر ته نصب شوی و؛ یا
   • د Python ډیری نسخې نصب شوي، مګر تاسو غواړئ API په وروستي نسخه کې نصب کړئ چې تاسو یې نصب کړی؛ یا
   • د Python یوازې یوه نسخه نصب شوې.
   • که چیرې د دې شرایطو څخه کوم یو پلي شي، وګورئ د بیچ په چلولو سره د پایتون ماډل نصب کړئ file پر
   • په نورو ټولو قضیو کې، د پایپ په کارولو سره د Python ماډل نصب کړئ. دا معمولا تطبیق کیږي که:
   • د Python ډیری نسخې نصب شوي، مګر تاسو غواړئ یو ځانګړي نسخه نصب کړئ؛ یا
   • د Python ډیری مختلف نسخې نصب شوي او تاسو غواړئ ټولو ته یې نصب کړئ (په دې حالت کې، تاسو باید د هرې نسخې لپاره ماډل نصب کړئ)؛ یا
   • د Python یوازې یوه نسخه نصب شوې، مګر تاسو PATH ته نه دی نصب کړی.
   • که د دې شرایطو څخه کوم یو پلي شي، د پایپ په چلولو سره د پایتون ماډل نصب کړئ وګورئ.

د بیچ په چلولو سره د Python ماډل نصب کړئ file د دې کولو لپاره:

1. د Python نصب فولډر ته لاړ شئ: C:\پروګرام Files\Vicon\Tracker4.x\SDK\Python
2. install_tracker_api.bat دوه ځله کلیک وکړئ.
   • د نصب کولو پروسه په اوتومات ډول پیل کیږي.

د پایپ چلولو له لارې د Python ماډل نصب کړئ

1. د Python لپاره د سکریپټ فولډر ته لاړ شئ چې تاسو یې کارول غواړئ:
2. د Python 3 لپاره، د نصب کولو اصلي فولډر دا دی: C: \ کاروونکي \ \AppData\Local\Programs\Python\Python \Sc rips
   • د Python 2.7 لپاره، د نصب کولو اصلي فولډر دا دی: C:\Python27\Scripts
3. په دې فولډر کې د کمانډ کړکۍ یا PowerShell خلاص کړئ.
4. د Vicon Core API نصبولو لپاره لاندې کمانډ چل کړئ: C: \ کاروونکي\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe نصب کړئ "C:\پروګرام Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • د Tracker API C نصبولو لپاره لاندې کمانډ چل کړئ: \ کاروونکي\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe نصب کړئ "C:\پروګرام Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

نوټ پورتني پخوانيamples د Tracker 3.11 سره د Python 4.0 انسټالشن کاروي. ستاسو لاره او حکمونه ممکن یو څه توپیر ولري.

وګورئ چې د Python ماډل په سمه توګه نصب شوی

• وګورئ چې لاندې ماډلونه نصب شوي دي.
• vicon_core_api: دا اصلي ریموټ کنټرول API دی او د ټرمینل سرور سره د اړیکو لپاره پیرودونکي شامل دي.
• tracker_api: د ټریکر ځانګړي غوښتنلیک فعالیت ته د لاسرسي لپاره د خدماتو API.
• د دې ازموینې لپاره چې د ټریکر پایتون ماډل په سمه توګه نصب شوی، په Python کې د یو ماډل واردولو هڅه وکړئ: >>> import vicon_core_api

که پورتنۍ پروسه د ماډل په پیژندلو کې پاتې راشي، لاندې هڅه وکړئ:

• د tracker_api یا vicon_core_api فولډر لپاره د Python انسټالشن کې د سایټ پیکج فولډر چیک کړئ. د Python 3.11 لپاره، د ډیفالټ نصب کولو فولډر موقعیت دا دی:
  • ج: کاروونکي \AppData\Local\Programs\Python\Python311\Lib\site-packages
• د خپل سیسټم چاپیریال متغیرونه چیک کړئ او ډاډ ترلاسه کړئ چې د Python نصبولو لپاره د سکریپټونو فولډر چې تاسو یې کارول غواړئ په لیست کې ترټولو لوړ دی. د Python 3.11 لپاره، د نصب کولو فولډر اصلي ځای دا دی:
  • ج: کاروونکي \AppData\Local\Programs\Python\Python311\Scripts
• که چیرې د ماډل فولډرونو څخه کوم یو ورک وي، او تاسو لاره تایید کړې وي، د نصب کولو پروسې له لارې بیا پیل کړئ چې د Tracker Python انډول په نصبولو کې تشریح شوي.

د ټرمینل سرور سره وصل کړئ

• د ټرمینل سرور سره وصل کیدو لپاره ، لومړی د ویکون کور API ماډل وارد کړئ: >>> vicon_core_api وارد کړئ
  • >>> د vicon_core_api واردولو څخه
• بیا، یو پیرودونکي جوړ کړئ. دا په اوتومات ډول هڅه کوي په ډیفالټ پورټ کې د ځانګړي کوربه پتې سره وصل شي (52800) >>> c = مراجع ('localhost')
• وګورئ چې پیرودونکي په بریالیتوب سره سرور سره وصل شوي: >>> چاپ(c.connected) ریښتیا
• که ځواب غلط وي، ډاډ ترلاسه کړئ چې تاسو په ټاکل شوي کوربه پته کې د ټریکر چلولو مثال لرئ او ستاسو فایر وال د نوي پیرودونکي رامینځته کولو دمخه په 52800 بندر کې ترافیک نه بندوي.
• کله چې تاسو په بریالیتوب سره وصل شئ، تاسو کولی شئ د ټریکر ټرمینل سرور لخوا چمتو شوي خدماتو ته لاسرسی ومومئ.
• دا پخوانیample د بنسټیز اعتراض خدمتونه کاروي: >>> د tracker_api وارد کړئ >>> د tracker_api څخه وارد کړئ BasicObjectServices >>> خدمات = BasicObjectServices(c)
• کله چې دا وصل شي، تاسو کولی شئ د ټریکر مثال کې میتودونو ته زنګ ووهئ.
  • د مثال لپارهample، د تعقیب پینل کې د شیانو لیست ترلاسه کولو لپاره، وکاروئ: >>> پایله، object_list = services.basic_object_list() >>> چاپ (نتیجه)
  • سمه ده: فعالیت بریالی شو
  • >>> چاپ (د اعتراض_لست)
  • ['Object1', 'Object2'...]
• ټول API کالونه د پایلې کوډ بیرته راوړي، کوم چې په vicon_core_api/result.py کې تشریح شوي.
• یو احتمالي ناکامي کوډ Result.RPCNotConnected دی، کوم چې ترلاسه کیږي که چیرې د ټرمینل سرور سره اړیکه له لاسه ورکړي.
• د مثال لپارهample: >>> پایله، object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: د ریموټ فعالیت یا کال بیک سره پیوستون خلاص ندی
• د ټولو موجودو دندو او اسنادو لیست ښودلو لپاره: >>> مرسته( tracker_api)

Example سکریپټ

• تاسو کولی شئ پخوانی ومومئample سکریپټونه په کې د عام API افعال کارول ښیې C:\پروګرام Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• ټول سکریپټونه اسناد لري او د مرستې اختیار اخلي چې د اړونده دلیلونو توضیحات ورکوي.
• په توګه د چلولو لپارهample سکریپټ، پورته د سکریپټ فولډر کې د کمانډ کړکۍ یا د بریښنا شیل خلاص کړئ. تاسو کولی شئ دا په دوو لارو کې ترسره کړئ:
• د کمانډ پرامپټ خلاص کړئ او خپل لارښود د سکریپټ فولډر ته بدل کړئ: c:\> cd C:\پروګرام Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• د سکریپټ فولډر کې SHIFT + ښیې کلیک وکړئ او دلته د کمانډ کړکۍ خلاص کړئ یا دلته د پاورشیل کړکۍ خلاص کړئ غوره کړئ.
• له دې ځایه تاسو کولی شئ پخوانی چل کړئampستاسو د خوښې سکریپټ.
• لاندې پخوانيampد کمانډ کړکۍ وکاروئ.

camera_calibration_wave.py

• دا سکریپټ ښیې چې څنګه د وینډ څپې پیل او ودرولو کیلیبریشن پروسې کنټرول لپاره د API افعال وکاروئ.
  • C:\پروګرام Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• که بریالی وي، د کیلیبریشن کنټرولونه ښودل کیږي

capture_control.py

• دا سکریپټ ښیې چې څنګه ژوندی ډیټا نیول C:\پروګرام Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• د کیپچر نوم د کنټرول څخه دمخه لیست شوی. د نیولو نوم بدلولو لپاره، capture_services او SetCaptureName وکاروئ.
• د Tracker API کارولو په اړه پوښتنو لپاره، د Vicon Support1 سره اړیکه ونیسئ.
• 1 بریښنالیک:support@vicon.com
• د ویکون ټریکر پایتون API د چټک پیل لارښود 31 می 2023، بیاکتنه 1
• د ټریکر 4.0 سره کارولو لپاره
• © د چاپ حق 2020–2023 Vicon Motion Systems Limited. ټول حقونه خوندي دي.
• بیاکتنه 1. د ټریکر 4.0 سره د کارولو لپاره
• Vicon Motion Systems Limited پرته له خبرتیا څخه په دې سند کې معلوماتو یا مشخصاتو کې د بدلون کولو حق خوندي کوي.
• شرکتونه، نومونه، او معلومات چې په مثال کې کارول کیږيamples جعلي دي پرته لدې چې بل ډول یادونه وشي. د دې خپرونې هیڅ برخه نشي تولید کیدی، د بیرته اخیستلو سیسټم کې زیرمه شي، یا په هر ډول یا په هر ډول، بریښنایی یا میخانیکي توګه، د فوتوکاپي یا ثبت کولو له لارې، یا بل ډول د Vicon Motion Systems Ltd له مخکینۍ لیکلي اجازې پرته لیږدول کیدی شي.
• Vicon® د اکسفورډ میټریک 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™ د اکسفورډ میټریکس plc سوداګریزې نښې دي.
• VESA® یو راجستر شوی سوداګریز نښه ده چې د VESA ملکیت دی (www.vesa.org/about-vesa/). دلته د نورو محصولاتو او شرکتونو نومونه ممکن د دوی د اړوندو مالکینو سوداګریزې نښې وي.
• د بشپړ او تازه نیټې کاپي حق او سوداګریزې نښې اعترافونو لپاره ، لیدنه وکړئ https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems د اکسفورډ میټریک plc شرکت دی.
• بریښنالیک: support@vicon.com Web: http://www.vicon.com

اسناد / سرچینې

VICON تعقیبونکی Python Api [pdf] د کارونکي لارښود تعقیبونکی Python Api، Tracker، Python Api، Api

حوالې

• د کارن لارښود