Python#

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

Các lệnh Python trong VEXcode VR có thể phụ thuộc vào Playground và robot bạn đang sử dụng. Một số robot bao gồm các phương thức độc đáo không xuất hiện trong mọi Playground.

Sân chơi và Robot trong Thực tế ảo#

Sử dụng phần Sân chơi để xem robot nào được sử dụng trong mỗi Sân chơi và để tìm chi tiết thiết lập cụ thể của Sân chơi, thông tin về sân và bối cảnh thử thách.

Sử dụng phần Robots để tìm các trang Python dành riêng cho robot có các phương thức độc đáo. Các trang Robots cũng hiển thị Playgrounds mà mỗi robot được sử dụng, vì vậy bạn có thể biết khi nào một phương thức dành riêng cho robot có sẵn trong dự án của bạn.

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.rotation(…).

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ố

Một tên lưu trữ một giá trị, ví dụ như angle = 90.

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ư DEGREES in drivetrain.rotation(DEGREES).

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

xoay#

Góc quay là mức độ robot đã xoay, được đo bằng độ. Khi bắt đầu một dự án, giá trị góc quay được đặt là 0 độ. Lệnh rotation trả về góc quay hiện tại của robot.

Xoay sang phải sẽ làm tăng góc quay, và xoay sang trái sẽ làm giảm góc quay. Ví dụ, xoay hai vòng sang phải sẽ tạo ra góc quay 720 độ.

Usage:
drivetrain.rotation(units)

Thông số

Sự miêu tả

units

Tùy chọn. Đơn vị xoay: DEGREES (mặc định).

def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)