Python

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

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

คำสั่ง Python ถูกใช้ในโปรเจ็กต์ VEXcode AIM Python ส่วนโปรเจ็กต์ Blocks จะใช้ส่วน Blocks API แทน

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

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

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

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

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

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

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

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

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

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

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

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

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

ย้ายที่

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

Usage:
robot.move_at(angle, velocity, units)

พารามิเตอร์	คำอธิบาย
angle	มุมที่หุ่นยนต์เคลื่อนที่ (หน่วยเป็นองศา) สามารถเป็นจำนวนเต็มหรือทศนิยมตั้งแต่ -360 ถึง 360 ได้
velocity	ตัวเลือกเสริม ความเร็วในการเคลื่อนที่สามารถกำหนดได้ตั้งแต่ 0% ถึง 100% เมื่อใช้ PERCENTหรือตั้งแต่ 0 ถึง 200 มิลลิเมตรต่อวินาที เมื่อใช้ MMPSค่านี้สามารถเป็นจำนวนเต็มหรือทศนิยมก็ได้ หากไม่ได้ระบุความเร็ว หุ่นยนต์จะเคลื่อนที่ด้วยความเร็วปัจจุบัน
units	เลือกได้ หน่วยความเร็ว: PERCENT ) หรือ MMPS ต่อวินาที

# Move forward
robot.move_at(0)