Python#

Tài liệu tham khảo API Python của VEX V5 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 V5. Các khối lệnh và dự án C++ sử dụng các phần API khác.

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ư 360.0 trong drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS).

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

lái xe#

Chế độ 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. Đối với tốc độ quay (RPM) hoặc độ trên giây, giới hạn được thay đổi bởi tỷ số truyền của hệ thống truyền động.

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 600 vòng/phút khi sử dụng RPM, hoặc từ 0 đến 3600 độ/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: RPM (vòng/phút, mặc định), PERCENThoặc VelocityUnits.DPS (độ/giây).

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


# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)
On this page