VICON Tracker Python API

ข้อมูลจำเพาะ

• ชื่อสินค้า : Vicon Tracker Python API
• ความเข้ากันได้: แทรคเกอร์ 4.0
• เวอร์ชัน Python ที่รองรับ: 2.7 และไพธอน 3

คำแนะนำการใช้ผลิตภัณฑ์

ติดตั้ง Tracker API

หากต้องการใช้ Tracker API กับ Python ให้ทำตามขั้นตอนเหล่านี้:

1. ตรวจสอบเวอร์ชัน Python เพื่อให้แน่ใจว่าเข้ากันได้
2. ติดตั้ง Python โดยดาวน์โหลดจากทางการ webเว็บไซต์และเลือกเวอร์ชันที่เหมาะสม
3. ค้นหาและติดตั้งโมดูล Tracker Python จากโฟลเดอร์ที่ระบุ

ตรวจสอบเวอร์ชัน Python

1. เปิดพรอมต์คำสั่ง
2. พิมพ์ 'py' แล้วกด Enter
3. หากไม่ได้ติดตั้ง Python โปรดดูคำแนะนำในการติดตั้ง

ติดตั้ง Python

1. ไปที่ อย่างเป็นทางการของหลาม webเว็บไซต์.
2. ดาวน์โหลดและติดตั้ง Python เพื่อให้แน่ใจว่าจะเพิ่ม python.exe ลงใน PATH ระหว่างการติดตั้ง

ติดตั้งโมดูล Tracker Python:

1. ค้นหาการติดตั้ง fileอยู่ในโฟลเดอร์ที่ระบุ
2. เลือกวิธีการติดตั้งตามการตั้งค่าของคุณ

ติดตั้งโมดูล Python โดยการรันแบทช์ File:

1. ไปที่โฟลเดอร์การติดตั้ง Python: C: Program FilesViconTracker4.xSDKPython
2. ดับเบิลคลิกที่ 'install_tracker_api.bat' เพื่อเริ่มกระบวนการติดตั้ง

คำถามที่พบบ่อย (FAQ) :

ถาม: ฉันจะทำให้อะไรเป็นอัตโนมัติโดยใช้ Tracker API ได้บ้าง

• A: Tracker API ช่วยให้คุณสามารถทำให้ฟังก์ชันทั่วไปเป็นอัตโนมัติ เช่น การโหลด การเล่น การส่งออกข้อมูล การเปิดใช้งาน/ปิดใช้งานออบเจ็กต์ และการทริกเกอร์ส่วนเวิร์กโฟลว์

ถาม: Tracker API รองรับ Python เวอร์ชันใดบ้าง

• A: Tracker API รองรับ Python เวอร์ชัน 2.7 และ Python

เกี่ยวกับคู่มือนี้

• Tracker API ช่วยให้คุณควบคุมคุณสมบัติบางอย่างของ Tracker ผ่าน Python API
• API ช่วยให้คุณสามารถทำให้ฟังก์ชันทั่วไปบางอย่างของ Tracker เป็นแบบอัตโนมัติได้ เช่น การโหลด การเล่น และการส่งออกข้อมูล การเปิดใช้งานหรือปิดใช้งานออบเจ็กต์ต่างๆ หรือการทริกเกอร์บางส่วนของเวิร์กโฟลว์
• เอกสารนี้ช่วยให้คุณสามารถเริ่มต้นใช้งาน Tracker API ได้

ติดตั้ง Tracker API

• หากต้องการใช้ Tracker API กับ Python คุณต้องตรวจสอบให้แน่ใจว่าคุณได้ติดตั้งทั้งสองอย่างแล้ว
• Tracker API ให้การสนับสนุน Python 2.7 และ Python 3 Vicon ขอแนะนำให้คุณใช้ Python 3 เวอร์ชันเต็มล่าสุด เว้นแต่โปรเจ็กต์ของคุณต้องการให้คุณใช้ Python เวอร์ชันเฉพาะ

ขั้นตอนเหล่านี้จะแนะนำคุณตลอดกระบวนการติดตั้ง:

• ตรวจสอบเวอร์ชัน Python บน
• การติดตั้ง Python บน
• การติดตั้งโมดูล Tracker Python บน
• ตรวจสอบว่าโมดูล Python ได้รับการติดตั้งอย่างถูกต้อง

ตรวจสอบเวอร์ชั่นของ Python

• หากคุณไม่แน่ใจว่าคุณติดตั้ง Python ไว้หรือไม่ หรือใช้ Python เวอร์ชันใดอยู่ คุณสามารถเปิด command prompt แล้วรันคำสั่ง py ได้

เช่นampเลอ:

หากคุณไม่ได้ติดตั้ง Python โปรดดูการติดตั้ง Python

ติดตั้ง 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
   • เหล่านี้ files จะแสดง:
2. ติดตั้งโมดูล Tracker Python ด้วยวิธีใดวิธีหนึ่งต่อไปนี้ ขึ้นอยู่กับการติดตั้งเฉพาะของคุณ:
   • วิธีที่ง่ายที่สุดคือการรันแบทช์ file (install_tracker_api.bat) ที่รวมอยู่ในการติดตั้ง Tracker (ดังแสดงในภาพด้านบน)
   • ซึ่งมักจะได้ผลดีหาก:
   • Python ได้รับการติดตั้งให้กับตัวแปร PATH; หรือ
   • มีการติดตั้ง Python หลายเวอร์ชัน แต่คุณต้องการติดตั้ง API เป็นเวอร์ชันล่าสุดที่คุณติดตั้ง หรือ
   • มีการติดตั้ง Python เวอร์ชันเดียวเท่านั้น
   • หากมีเงื่อนไขใดๆ เหล่านี้เกิดขึ้น โปรดดูที่การติดตั้งโมดูล python โดยการรันแบตช์ file บน.
   • ในกรณีอื่นๆ ทั้งหมด ให้ติดตั้งโมดูล Python โดยใช้ pip โดยปกติแล้วจะมีผลหาก:
   • มีการติดตั้ง Python หลายเวอร์ชัน แต่คุณต้องการติดตั้งเป็นเวอร์ชันเฉพาะ หรือ
   • มีการติดตั้ง Python ที่แตกต่างกันหลายเวอร์ชัน และคุณต้องการติดตั้งในทุกเวอร์ชัน (ในกรณีนี้ คุณต้องติดตั้งโมดูลสำหรับแต่ละเวอร์ชัน) หรือ
   • มีการติดตั้ง Python เวอร์ชันเดียวเท่านั้น แต่คุณไม่ได้ติดตั้งลงใน PATH
   • หากตรงตามเงื่อนไขใดๆ เหล่านี้ โปรดดูที่การติดตั้งโมดูล Python โดยเรียกใช้ pip on

ติดตั้งโมดูล Python โดยการรันแบตช์ file วิธีการทำสิ่งนี้:

1. นำทางไปยังโฟลเดอร์การติดตั้ง Python: C:\โปรแกรม Files\Vicon\Tracker4.x\SDK\Python
2. ดับเบิลคลิก install_tracker_api.bat
   • กระบวนการติดตั้งจะเริ่มต้นโดยอัตโนมัติ

ติดตั้งโมดูล Python โดยการรัน pip

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: นี่คือ API การควบคุมระยะไกลหลักและมีไคลเอ็นต์สำหรับการสื่อสารกับเทอร์มินัลเซิร์ฟเวอร์
• tracker_api: บริการ API สำหรับการเข้าถึงฟังก์ชันการทำงานของแอปพลิเคชันเฉพาะตัวติดตาม
• เพื่อทดสอบว่าโมดูล Tracker Python ได้รับการติดตั้งอย่างถูกต้อง ให้ลองนำเข้าหนึ่งในโมดูลใน Python: >>> import vicon_core_api

หากกระบวนการข้างต้นไม่สามารถจดจำโมดูลได้ ให้ลองทำดังนี้:

• ตรวจสอบโฟลเดอร์แพ็คเกจไซต์ในการติดตั้ง Python เพื่อหาโฟลเดอร์ tracker_api หรือ vicon_core_api สำหรับ Python 3.11 ตำแหน่งของโฟลเดอร์การติดตั้งเริ่มต้นคือ:
  • ค:\ผู้ใช้\ \AppData\Local\Programs\Python\Python311\Lib\site-แพ็คเกจ
• ตรวจสอบตัวแปรสภาพแวดล้อมระบบของคุณและตรวจสอบให้แน่ใจว่าโฟลเดอร์สคริปต์สำหรับการติดตั้ง Python ที่คุณต้องการใช้อยู่ในโฟลเดอร์สูงสุดในรายการ สำหรับ Python 3.11 ตำแหน่งเริ่มต้นของโฟลเดอร์การติดตั้งคือ:
  • ค:\ผู้ใช้\ \AppData\Local\Programs\Python\Python311\Scripts
• หากโฟลเดอร์ของโมดูลตัวใดตัวหนึ่งหายไป และคุณได้ตรวจสอบเส้นทางแล้ว ให้รันใหม่ผ่านกระบวนการติดตั้งที่อธิบายไว้ใน การติดตั้งโมดูล Tracker Python บน

เชื่อมต่อกับเซิร์ฟเวอร์เทอร์มินัล

• หากต้องการเชื่อมต่อกับเทอร์มินัลเซิร์ฟเวอร์ ก่อนอื่นให้นำเข้าโมดูล Vicon Core API: >>> นำเข้า vicon_core_api
  • >>> จากการนำเข้า vicon_core_api
• ต่อไป สร้างไคลเอนต์ สิ่งนี้จะพยายามเชื่อมต่อกับที่อยู่โฮสต์เฉพาะบนพอร์ตเริ่มต้น (52800) >>> c = Client('localhost') โดยอัตโนมัติ
• ตรวจสอบว่าไคลเอนต์เชื่อมต่อกับเซิร์ฟเวอร์สำเร็จ: >>> พิมพ์ (c.connected) จริง
• หากการตอบสนองเป็นเท็จ ตรวจสอบให้แน่ใจว่าคุณมีอินสแตนซ์ของ Tracker ที่ทำงานอยู่ที่ที่อยู่โฮสต์ที่ระบุ และไฟร์วอลล์ของคุณไม่ได้ปิดกั้นการรับส่งข้อมูลบนพอร์ต 52800 ก่อนที่จะสร้างไคลเอนต์ใหม่
• เมื่อคุณเชื่อมต่อสำเร็จแล้ว คุณจะสามารถเข้าถึงบริการต่างๆ ที่ได้รับจากเซิร์ฟเวอร์เทอร์มินัล Tracker
• อดีตนี้ample ใช้บริการอ็อบเจ็กต์พื้นฐาน: >>> นำเข้า tracker_api >>> จาก tracker_api นำเข้า BasicObjectServices >>> บริการ = BasicObjectServices(c)
• เมื่อเชื่อมต่อแล้ว คุณสามารถเรียกใช้วิธีการบนอินสแตนซ์ Tracker ได้
  • เช่นample หากต้องการดูรายการออบเจ็กต์ในแผงการติดตาม ให้ใช้: >>> result, object_list = services.basic_object_list() >>> print(result)
  • ตกลง: ฟังก์ชั่นสำเร็จ
  • >>> พิมพ์ ( 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: การเชื่อมต่อกับฟังก์ชันระยะไกลหรือการโทรกลับไม่ได้เปิดอยู่
• หากต้องการแสดงรายการฟังก์ชันและเอกสารประกอบที่มีอยู่ทั้งหมด: >>> help( tracker_api)

Exampไฟล์สคริปต์

• คุณสามารถหาแฟนเก่าได้ampสคริปต์ le แสดงการใช้ฟังก์ชัน API ทั่วไปที่ C:\โปรแกรม Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• สคริปต์ทั้งหมดมีเอกสารประกอบและใช้ตัวเลือก –help ที่ให้รายละเอียดของข้อโต้แย้งที่เกี่ยวข้อง
• วิ่งเป็นample script ให้เปิดหน้าต่างคำสั่งหรือ Power Shell ในโฟลเดอร์สคริปต์ด้านบน คุณสามารถทำได้ด้วยวิธีใดวิธีหนึ่งจากสองวิธี:
• เปิดพรอมต์คำสั่งและเปลี่ยนไดเร็กทอรีของคุณเป็นโฟลเดอร์สคริปต์: c:\> ซีดี C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• กด SHIFT+คลิกขวาในโฟลเดอร์สคริปต์และเลือก เปิดหน้าต่างคำสั่งที่นี่ หรือ เปิดหน้าต่าง Powershell ที่นี่
• จากที่นี่คุณสามารถเรียกใช้อดีตได้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:\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
• อีเมล: support@vicon.com Web: http://www.vicon.com

เอกสาร / แหล่งข้อมูล

VICON Tracker Python Api [พีดีเอฟ] คู่มือการใช้งาน ตัวติดตามหลาม Api, ตัวติดตาม, Python Api, Api

อ้างอิง

• คู่มือการใช้งาน