Πύθων

Η αναφορά VEX AIM Python API εξηγεί τι κάνει κάθε εντολή, μέθοδος και συνάρτηση, ποιες εισόδους χρησιμοποιεί, τι επιστρέφει και πώς μπορεί να χρησιμοποιηθεί σε ένα έργο.

Χρησιμοποιήστε αυτήν την αναφορά όταν θέλετε να κατανοήσετε μια εντολή πριν την προσθέσετε σε ένα έργο, να ελέγξετε ποιες τιμές δέχεται ή επιστρέφει ή να συγκρίνετε σχετικές εντολές σε μια κατηγορία.

Οι εντολές Python χρησιμοποιούνται σε έργα Python VEXcode AIM. Τα έργα Blocks χρησιμοποιούν αντ’ αυτού την ενότητα Blocks API.

Πώς να διαβάσετε μια καταχώρηση μεθόδου

Οι περισσότερες καταχωρήσεις Python περιλαμβάνουν τα ακόλουθα μέρη:

• Όνομα εντολής - Το επίσημο όνομα της εντολής, της μεθόδου ή της συνάρτησης.

• Περιγραφή - Εξηγεί τι κάνει η εντολή και πότε είναι χρήσιμη.

• Χρήση - Εμφανίζει τη σύνταξη που χρησιμοποιείται για την εγγραφή της εντολής στον κώδικα.

• Παράμετροι - Παραθέτει τις εισόδους που δέχεται η εντολή και εξηγεί τι κάνει η καθεμία.

• Επιστροφή τιμής - Εξηγεί τι αναφέρει η εντολή, εάν επιστρέφει μια τιμή.

• Παράδειγμα κώδικα - Δείχνει έναν τρόπο με τον οποίο μπορεί να χρησιμοποιηθεί η εντολή σε ένα έργο.

Κοινά στοιχεία API Python

Στοιχείο	Τι σημαίνει
Μέθοδος	A command called on an object such as robot.move_at(…).
Λειτουργία	A command called directly, such as wait(…) or print(…).
Παράμετρος	Μια τιμή που μεταβιβάζεται σε μια μέθοδο ή συνάρτηση για να ελέγχει τι κάνει.
Προαιρετική παράμετρος	Μια παράμετρος που μπορεί να παραλειφθεί, ώστε να χρησιμοποιηθεί η προεπιλεγμένη συμπεριφορά.
Επιστρεφόμενη τιμή	Μια τιμή που αναφέρει μια εντολή, όπως ένας αριθμός, ένα κείμενο ή μια λογική τιμή.

Βασικό λεξιλόγιο Python

Ορος	Τι σημαίνει
Μεταβλητός	A name that stores a value, such as speed = 50.
Σειρά	Text inside quotes, such as “Hello”.
Ακέραιος αριθμός	A positive or negative number, such as 90.
Φλοτέρ	A number with a decimal, such as 25.5.
Λογική τιμή	A value that is either True or False.
Επιχείρημα	A value passed into a method or function call, such as 0 in robot.move_at(0).

Παράδειγμα εισαγωγής μεθόδου

μετακίνηση_σε

move_at moves the robot forever at a specific angle. The robot will continue to move until it is given another action, like moving at a different angle, turning, or stopping.

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

Παράμετροι	Περιγραφή
angle	Η γωνία, σε μοίρες, κατά την οποία κινείται το ρομπότ. Αυτή μπορεί να είναι ακέραιος ή δεκαδικός αριθμός από -360 έως 360.
velocity	Optional. The velocity to move with from 0% to 100% when using PERCENT, or from 0 to 200 millimeters per second when using MMPS. This can be an integer or decimal. If no velocity is provided, the robot moves at the current move velocity.
units	Optional. The velocity unit: PERCENT (default) or MMPS (millimeters per second).

# Move forward
robot.move_at(0)