Python

เอกสารอ้างอิง VEX V5 Python API อธิบายว่าคำสั่ง เมธอด และฟังก์ชันแต่ละอย่างทำอะไร รับอินพุตอะไรบ้าง ส่งคืนค่าอะไร และสามารถนำไปใช้ในโปรเจ็กต์ได้อย่างไร

ใช้เอกสารอ้างอิงนี้เมื่อคุณต้องการทำความเข้าใจคำสั่งก่อนที่จะเพิ่มลงในโปรเจ็กต์ ตรวจสอบค่าที่คำสั่งนั้นยอมรับหรือส่งคืน หรือเปรียบเทียบคำสั่งที่เกี่ยวข้องในหมวดหมู่เดียวกัน

คำสั่ง Python ถูกใช้ในโปรเจ็กต์ Python ของ VEXcode V5 ส่วนบล็อกและโปรเจ็กต์ C++ จะใช้ส่วน API อื่นๆ แทน

วิธีการอ่านข้อมูลเมธอด

บทความเกี่ยวกับ Python ส่วนใหญ่ประกอบด้วยส่วนต่างๆ ดังต่อไปนี้:

• ชื่อคำสั่ง - ชื่ออย่างเป็นทางการของคำสั่ง เมธอด หรือฟังก์ชัน

• คำอธิบาย - อธิบายว่าคำสั่งนี้ทำอะไรและมีประโยชน์เมื่อใด

• วิธีใช้งาน - แสดงไวยากรณ์ที่ใช้ในการเขียนคำสั่งในโค้ด

• พารามิเตอร์ - แสดงรายการอินพุตที่คำสั่งยอมรับและอธิบายว่าแต่ละพารามิเตอร์ทำอะไรบ้าง

• ค่าที่ส่งกลับ - อธิบายว่าคำสั่งนั้นส่งค่าอะไรกลับมา หากมีการส่งค่ากลับมา

• ตัวอย่างโค้ด - แสดงวิธีการใช้งานคำสั่งนี้ในโปรเจ็กต์

องค์ประกอบ API ทั่วไปของ Python

องค์ประกอบ	มันหมายความว่าอย่างไร
วิธี	คำสั่งที่เรียกใช้กับวัตถุ เช่น drivetrain.drive(…).
การทำงาน	คำสั่งที่เรียกใช้โดยตรง เช่น wait(…) หรือ print(…)
พารามิเตอร์	ค่าที่ส่งเข้าไปในเมธอดหรือฟังก์ชันเพื่อควบคุมการทำงานของมัน
พารามิเตอร์เสริม	พารามิเตอร์ที่สามารถละเว้นได้เพื่อให้ระบบใช้พฤติกรรมเริ่มต้น
ค่าที่ส่งคืน	ค่าที่คำสั่งส่งกลับมา เช่น ตัวเลข ข้อความ หรือค่าบูลีน

คำศัพท์พื้นฐานของ Python

ภาคเรียน	มันหมายความว่าอย่างไร
ตัวแปร	ชื่อที่เก็บค่าไว้ เช่น speed = 50
สตริง	ข้อความภายในเครื่องหมายคำพูด เช่น “Hello”.
จำนวนเต็ม	ตัวเลขบวกหรือลบ เช่น 90
ลอย	ตัวเลขที่มีจุดทศนิยม เช่น 25.5
บูลีน	ค่าที่ได้คือ True หรือ False)
การโต้แย้ง	ค่าที่ส่งผ่านเข้าไปในการเรียกเมธอดหรือฟังก์ชัน เช่น 360.0 ใน drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)

ตัวอย่างการป้อนข้อมูลวิธีการ

ขับ

drive จะทำให้หุ่นยนต์เคลื่อนที่ไปข้างหน้าหรือถอยหลังอย่างไม่มีที่สิ้นสุด หุ่นยนต์จะเคลื่อนที่ต่อไปจนกว่าจะได้รับคำสั่งอื่น เช่น การเลี้ยวหรือการหยุด สำหรับ RPM หรือองศาต่อวินาที ขีดจำกัดจะเปลี่ยนแปลงไปตามอัตราทดเกียร์ของระบบขับเคลื่อน

Usage:
drivetrain.drive(direction, velocity, units)

พารามิเตอร์	คำอธิบาย
direction	ทิศทางการเคลื่อนที่ของหุ่นยนต์: FORWARD หรือ REVERSE
velocity	ตัวเลือกเสริม ความเร็วในการขับเคลื่อนสามารถกำหนดได้ตั้งแต่ 0% ถึง 100% เมื่อใช้ PERCENT, ตั้งแต่ 0 ถึง 600 รอบต่อนาที เมื่อใช้ RPM RPMหรือตั้งแต่ 0 ถึง 3600 องศาต่อวินาที เมื่อใช้ VelocityUnits.DPS VelocityUnits.DPSค่านี้สามารถเป็นจำนวนเต็ม integer หรือทศนิยม ( floatfloat) หากไม่ได้ระบุความเร็ว หุ่นยนต์จะขับเคลื่อนด้วยความเร็วในการขับเคลื่อนปัจจุบัน
units	ตัวเลือกเสริม หน่วยความเร็ว: RPM (รอบต่อนาที ค่าเริ่มต้น), PERCENTหรือ VelocityUnits.DPS (องศาต่อวินาที)

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)