Python#

Tài liệu tham khảo API Python của VEX AIM 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 AIM. Các dự án Blocks sử dụng phần API dành cho Blocks thay thế.

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ư robot.move_at(…).

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ư 0 trong robot.move_at(0).

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

di chuyển tại#

Lệnh move_at di chuyển robot liên tục ở một góc cụ thể. Robot sẽ tiếp tục di chuyển cho đến khi nhận được lệnh khác, chẳng hạn như di chuyển ở góc khác, quay đầu hoặc dừng lại.

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

Thông số

Sự miêu tả

angle

Góc quay của robot, tính bằng độ. Giá trị này có thể là số nguyên hoặc số thập phân từ -360 đến 360.

velocity

Tùy chọn. Vận tốc di chuyển từ 0% đến 100% khi sử dụng PERCENT, hoặc từ 0 đến 200 milimét mỗi giây khi sử dụng MMPS. Giá trị này có thể là số nguyên hoặc số thập phân. 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) hoặc MMPS (milimét trên giây).

# Move forward
robot.move_at(0)