Python#

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

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

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

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

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

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

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

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

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

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

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

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

องค์ประกอบ

มันหมายความว่าอย่างไร

วิธี

คำสั่งที่เรียกใช้กับวัตถุ เช่น drivetrain.drive(…).

การทำงาน

คำสั่งที่เรียกใช้โดยตรง เช่น wait(…) หรือ print(…)

พารามิเตอร์

ค่าที่ส่งเข้าไปในเมธอดหรือฟังก์ชันเพื่อควบคุมการทำงานของมัน

พารามิเตอร์เสริม

พารามิเตอร์ที่สามารถละเว้นได้เพื่อให้ระบบใช้พฤติกรรมเริ่มต้น

ค่าที่ส่งคืน

ค่าที่คำสั่งส่งกลับมา เช่น ตัวเลข ข้อความ หรือค่าบูลีน

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

ภาคเรียน

มันหมายความว่าอย่างไร

ตัวแปร

ชื่อที่เก็บค่า เช่น distance = 200

สตริง

ข้อความภายในเครื่องหมายคำพูด เช่น “Hello”.

จำนวนเต็ม

ตัวเลขบวกหรือลบ เช่น 90

ลอย

ตัวเลขที่มีจุดทศนิยม เช่น 25.5

บูลีน

ค่าที่ได้คือ True หรือ False)

การโต้แย้ง

ค่าที่ส่งผ่านเข้าไปในการเรียกเมธอดหรือฟังก์ชัน เช่น FORWARD ใน drivetrain.drive(FORWARD).

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

ขับ#

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

Usage:
drivetrain.drive(direction)

พารามิเตอร์

คำอธิบาย

direction

ทิศทางการเคลื่อนที่ของหุ่นยนต์: FORWARD หรือ REVERSE

# Build Used: Code Base 2.0
def main():
    # Drive forward then stop
    drivetrain.drive(FORWARD)
    wait(2, SECONDS)
    drivetrain.stop()

# Start threads - Do not delete
start_thread(main)