Python#

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

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

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

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

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

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

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

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

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

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

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

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

Στοιχείο

Τι σημαίνει

Μέθοδος

Μια εντολή που καλείται σε ένα αντικείμενο όπως robot.move_at(…).

Λειτουργία

Μια εντολή που καλείται απευθείας, όπως wait(…) ή print(…).

Παράμετρος

Μια τιμή που μεταβιβάζεται σε μια μέθοδο ή συνάρτηση για να ελέγχει τι κάνει.

Προαιρετική παράμετρος

Μια παράμετρος που μπορεί να παραλειφθεί, ώστε να χρησιμοποιηθεί η προεπιλεγμένη συμπεριφορά.

Επιστρεφόμενη τιμή

Μια τιμή που αναφέρει μια εντολή, όπως ένας αριθμός, ένα κείμενο ή μια λογική τιμή.

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

Ορος

Τι σημαίνει

Μεταβλητός

Ένα όνομα που αποθηκεύει μια τιμή, όπως speed = 50.

Σειρά

Κείμενο μέσα σε εισαγωγικά, όπως “Hello”.

Ακέραιος αριθμός

Ένας θετικός ή αρνητικός αριθμός, όπως 90.

Φλοτέρ

Ένας αριθμός με δεκαδικό ψηφίο, όπως 25.5.

Λογική τιμή

Μια τιμή που είναι είτε True είτε False.

Επιχείρημα

Μια τιμή που μεταβιβάζεται σε μια κλήση μεθόδου ή συνάρτησης, όπως 0 σε robot.move_at(0).

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

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

Η συνάρτηση move_at μετακινεί το ρομπότ για πάντα υπό μια συγκεκριμένη γωνία. Το ρομπότ θα συνεχίσει να κινείται μέχρι να του δοθεί μια άλλη ενέργεια, όπως να κινηθεί υπό διαφορετική γωνία, να στρίψει ή να σταματήσει.

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

Παράμετροι

Περιγραφή

angle

Η γωνία, σε μοίρες, κατά την οποία κινείται το ρομπότ. Αυτή μπορεί να είναι ακέραιος ή δεκαδικός αριθμός από -360 έως 360.

velocity

Προαιρετικό. Η ταχύτητα κίνησης κυμαίνεται από 0% έως 100% όταν χρησιμοποιείται PERCENTή από 0 έως 200 χιλιοστά ανά δευτερόλεπτο όταν χρησιμοποιείται MMPSΑυτή μπορεί να είναι ακέραια ή δεκαδική τιμή. Εάν δεν παρέχεται ταχύτητα, το ρομπότ κινείται με την τρέχουσα ταχύτητα κίνησης.

units

Προαιρετικά. Η μονάδα ταχύτητας: PERCENT (προεπιλογή) ή MMPS (χιλιοστά ανά δευτερόλεπτο).

# Move forward
robot.move_at(0)