Python

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ถอดออก

take_off จะเริ่มการทำงานของใบพัดและยกโดรนขึ้นสู่อากาศ ต้องใช้วิธีนี้ก่อนจึงจะสามารถทำการเคลื่อนไหวอื่นๆ ได้

วิธีใช้:

drone.take_off(climb_to, units, wait)

พารามิเตอร์	คำอธิบาย
climb_to	ตำแหน่ง z ที่โดรนจะบินไป
units	หน่วยที่ใช้: CM - เซนติเมตร MM - มิลลิเมตร INCHES
wait	ตัวเลือกเสริม wait=True (ค่าเริ่มต้น) - โดรนจะรอจนกว่า take_off จะเสร็จสมบูรณ์ก่อนที่จะดำเนินการโค้ดบรรทัดถัดไป wait=False - โดรนจะเริ่มการทำงานและไปยังโค้ดบรรทัดถัดไปทันทีโดยไม่ต้องรอให้ take_off เสร็จสิ้น

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()