Python#

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

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

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

หมายเหตุ: IQ (รุ่นที่ 2) รัน Python ผ่านเครื่องเสมือนที่มีหน่วยความจำจำกัด แม้ว่าจะมีขนาดโค้ดต้นฉบับสูงสุด แต่การทำงานของโปรแกรมก็ขึ้นอยู่กับความซับซ้อนของโปรแกรมด้วย (เช่น จำนวนฟังก์ชัน ตัวแปร และตรรกะที่ใช้) ดังนั้น โปรแกรมที่มีขนาดใหญ่หรือซับซ้อนอาจไม่สามารถคอมไพล์หรือรันได้ แม้ว่าจะมีขนาดไม่เกินขีดจำกัดก็ตาม โปรแกรม C/C++ โดยทั่วไปจะได้รับผลกระทบจากข้อจำกัดเหล่านี้ใน IQ (รุ่นที่ 2) น้อยกว่า

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

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

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

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

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

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

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

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

ขับ#

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

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

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

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

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()