Python#

Tài liệu tham khảo API Python của VEX IQ (thế hệ thứ 2) giải thích chức năng của từng lệnh, phương thức và hàm, các tham số đầu vào mà chúng sử dụng, giá trị trả về và cách sử dụng chúng trong một dự án.

Hãy sử dụng tài liệu tham khảo này khi bạn muốn hiểu rõ một lệnh trước khi thêm nó vào dự án, kiểm tra các giá trị mà lệnh đó chấp nhận hoặc trả về, hoặc so sánh các lệnh liên quan trong cùng một danh mục.

Các lệnh Python được sử dụng trong các dự án Python của VEXcode IQ (thế hệ thứ 2). Các khối lệnh và dự án C++ sử dụng các phần API khác.

Lưu ý: Bộ xử lý IQ (thế hệ thứ 2) chạy Python thông qua một máy ảo với bộ nhớ hạn chế. Mặc dù có giới hạn kích thước mã nguồn tối đa, nhưng việc một chương trình có chạy được hay không còn phụ thuộc vào độ phức tạp của nó (chẳng hạn như số lượng hàm, biến và logic được sử dụng). Do đó, các chương trình lớn hoặc phức tạp có thể không biên dịch hoặc chạy được ngay cả khi chúng nằm trong giới hạn kích thước. Các chương trình C/C++ thường ít bị ảnh hưởng bởi các giới hạn này trên IQ (thế hệ thứ 2).

Cách đọc mục phương pháp#

Hầu hết các bài viết về Python đều bao gồm các phần sau:

  • Tên lệnh - Tên chính thức của lệnh, phương thức hoặc hàm.

  • Mô tả - Giải thích lệnh này làm gì và khi nào thì nó hữu ích.

  • Cách sử dụng - Hiển thị cú pháp được sử dụng để viết lệnh trong mã.

  • Tham số - Liệt kê các tham số đầu vào mà lệnh chấp nhận và giải thích chức năng của từng tham số.

  • Giá trị trả về - Giải thích những gì lệnh trả về, nếu nó trả về một giá trị.

  • Ví dụ mã lệnh - Minh họa một cách sử dụng lệnh này trong dự án.

Các thành phần API Python thông dụng#

Yếu tố

Ý nghĩa của nó là gì

Phương pháp

Một lệnh được gọi trên một đối tượng như drivetrain.drive(…).

Chức năng

Một lệnh được gọi trực tiếp, chẳng hạn như wait(…) hoặc print(…).

Tham số

Một giá trị được truyền vào phương thức hoặc hàm để điều khiển hoạt động của nó.

Tham số tùy chọn

Một tham số có thể bỏ qua để sử dụng hành vi mặc định.

Giá trị trả về

Giá trị mà một lệnh trả về, chẳng hạn như số, văn bản hoặc giá trị Boolean.

Từ vựng cơ bản của Python#

Thuật ngữ

Ý nghĩa của nó là gì

Biến số

Tên dùng để lưu trữ một giá trị, ví dụ như speed = 50.

Sợi dây

Văn bản nằm trong dấu ngoặc kép, ví dụ như “Hello”.

Số nguyên

Một số dương hoặc số âm, chẳng hạn như 90.

Trôi nổi

Một số có phần thập phân, chẳng hạn như 25.5.

Boolean

Một giá trị có thể là True hoặc False.

Lý lẽ

Một giá trị được truyền vào một phương thức hoặc lời gọi hàm, chẳng hạn như REVERSE trong drivetrain.drive(REVERSE, 20, PERCENT).

Ví dụ về cách nhập#

lái xe#

Phím drive cho phép robot di chuyển tiến hoặc lùi liên tục. Robot sẽ tiếp tục di chuyển cho đến khi nhận được lệnh khác, chẳng hạn như rẽ hoặc dừng lại.

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

Thông số

Sự miêu tả

direction

Hướng di chuyển của robot: FORWARD hoặc REVERSE.

velocity

Tùy chọn. Vận tốc di chuyển từ 0% đến 100% khi sử dụng PERCENT, từ 0 đến 120 vòng/phút khi sử dụng RPM, hoặc từ 0 đến 720 độ/giây khi sử dụng VelocityUnits.DPSGiá trị này có thể là integer hoặc số thập phân (float). Nếu không cung cấp vận tốc, robot sẽ di chuyển với vận tốc hiện tại.

units

Tùy chọn. Đơn vị vận tốc: PERCENT (mặc định), RPM (vòng/phút), hoặc VelocityUnits.DPS (độ/giây).

 
# 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()
On this page