Ελεγκτής#

Εισαγωγή#

Ο ελεγκτής VEX EXP διαθέτει κουμπιά και δύο joystick. Οι μέθοδοι του ελεγκτή μπορούν να χρησιμοποιηθούν για τον έλεγχο των πατημάτων κουμπιών, την ανάγνωση της κίνησης του joystick, την ενεργοποίηση ή απενεργοποίηση των διαμορφωμένων ενεργειών του ελεγκτή ή την εκτέλεση λειτουργιών όταν συμβαίνουν συμβάντα του ελεγκτή.

Configured controller actions are controller behaviors set in the Devices menu. Use remote_control_code_enabled to temporarily enable or disable those configured actions during a project.

This page uses controller as the example controller name. Replace it with your own configured name as needed.

Παρακάτω είναι μια λίστα με όλες τις διαθέσιμες μεθόδους:

Ενέργεια — Ενεργοποίηση ή απενεργοποίηση των διαμορφωμένων ενεργειών του χειριστηρίου.

Λήψη κουμπιών — Ανάγνωση καταστάσεων κουμπιών και θέσεων joystick.

  • .pressing — Returns whether a specified button is being pressed.

  • .position — Returns the position of a specified joystick axis.

Επανακλήσεις — Εκτέλεση συναρτήσεων όταν αλλάζει η είσοδος του ελεγκτή.

  • .pressed — Runs a function when a specified button is pressed.

  • .released — Runs a function when a specified button is released.

  • .changed — Runs a function when the joystick’s position changes along a specified axis.

Κατασκευαστής — Δημιουργήστε χειροκίνητα ένα αντικείμενο Ελεγκτή.

Δράση#

remote_control_code_enabled#

remote_control_code_enabled is a variable that enables or disables controller actions configured in the Devices menu. Controller configured actions are enabled by default.

Usage:
remote_control_code_enabled = state

Αξία

Περιγραφή

True

Ενεργοποιεί ενέργειες που έχουν ρυθμιστεί από τον ελεγκτή.

False

Απενεργοποιεί τις ενέργειες που έχουν ρυθμιστεί από τον ελεγκτή.

# Drive forward or backward using the left joystick
remote_control_code_enabled = False

while True:
    if controller.axis3.position() > 0:
        drivetrain.drive(FORWARD)
    elif controller.axis3.position() < 0:
        drivetrain.drive(REVERSE)
    # Press A to use controller configured actions again
    elif controller.buttonA.pressing():
        break
    else:
        drivetrain.stop()

    wait(20, MSEC)

remote_control_code_enabled = True

Αποκτητές#

.pressing#

.pressing returns whether a specific button on the controller is currently being pressed. This method must be called on a specific button object, such as controller.buttonA.

  • True — The specified button is being pressed.

  • False — The specified button is not being pressed.

Χρήση:
Ένα από τα διαθέσιμα αντικείμενα κουμπιών μπορεί να χρησιμοποιηθεί με αυτήν τη μέθοδο:

Η μπροστινή και η πάνω πλευρά του χειριστηρίου EXP με τα joystick, τα κουμπιά βέλους και τα κουμπιά δράσης επισημασμένα με κίτρινο χρώμα. Στην επιφάνεια του χειριστηρίου υπάρχουν δύο joystick αριστερά και δεξιά, με κουμπιά βέλους πάνω και κάτω αριστερά και κουμπιά A και B δεξιά. Στο πάνω μέρος του χειριστηρίου βρίσκονται τα L1 και L2 στην αριστερή πλευρά και τα R1 και R2 στη δεξιά πλευρά.

Κουμπί

Εντολή

buttonA

controller.buttonA.pressing() — The A button

buttonB

controller.buttonB.pressing() — The B button

buttonDown

controller.buttonDown.pressing() — The Down button

buttonUp

controller.buttonUp.pressing() — The Up button

buttonL1

controller.buttonL1.pressing() — The L1 button

buttonL2

controller.buttonL2.pressing() — The L2 button

buttonL3

controller.buttonL3.pressing() — The L3 button

buttonR1

controller.buttonR1.pressing() — The R1 button

buttonR2

controller.buttonR2.pressing() — The R2 button

buttonR3

controller.buttonR3.pressing() — The R3 button

Παράμετροι

Περιγραφή

Αυτή η μέθοδος δεν έχει παραμέτρους.

# Turn right while L1 is pressed
while True:
    if controller.buttonL1.pressing():
        drivetrain.turn(RIGHT)
    else:
        drivetrain.stop()

    wait(20, MSEC)

.position#

.position returns the position of a joystick axis as a number from -100 to 100.

This method must be called on a specific axis object, such as controller.axis1.

Χρήση:
Ένα από τα διαθέσιμα αντικείμενα άξονα μπορεί να χρησιμοποιηθεί με αυτήν τη μέθοδο:

Η μπροστινή πλευρά του χειριστηρίου EXP με τους αριθμούς άξονων του joystick επισημασμένους με κόκκινο χρώμα. Στην επιφάνεια του χειριστηρίου, το αριστερό joystick φέρει την ένδειξη Άξονας 4 για κίνηση αριστερά και δεξιά και Άξονας 3 για κίνηση πάνω και κάτω, ενώ το δεξί joystick φέρει την ένδειξη Άξονας 1 για κίνηση αριστερά και δεξιά και Άξονας 2 για κίνηση πάνω και κάτω.

Αξονας

Εντολή

axis1

controller.axis1.position() — The right joystick’s horizontal axis

axis2

controller.axis2.position() — The right joystick’s vertical axis

axis3

controller.axis3.position() — The left joystick’s vertical axis

axis4

controller.axis4.position() — The left joystick’s horizontal axis

Παράμετροι

Περιγραφή

Αυτή η μέθοδος δεν έχει παραμέτρους.

# Turn with the left joystick
remote_control_code_enabled = False

while True:
    if controller.axis4.position() > 10:
        drivetrain.turn(RIGHT)
    elif controller.axis4.position() < -10:
        drivetrain.turn(LEFT)
    else:
        drivetrain.stop()

    wait(20, MSEC)

Επανακλήσεις#

.pressed#

.pressed runs a function when the specified button is pressed. Once it is used, the function will run automatically each time that button is pressed.

Χρήση:
Ένα από τα διαθέσιμα αντικείμενα κουμπιών μπορεί να χρησιμοποιηθεί με αυτήν τη μέθοδο:

Η μπροστινή και η πάνω πλευρά του χειριστηρίου EXP με τα joystick, τα κουμπιά βέλους και τα κουμπιά δράσης επισημασμένα με κίτρινο χρώμα. Στην επιφάνεια του χειριστηρίου υπάρχουν δύο joystick αριστερά και δεξιά, με κουμπιά βέλους πάνω και κάτω αριστερά και κουμπιά A και B δεξιά. Στο πάνω μέρος του χειριστηρίου βρίσκονται τα L1 και L2 στην αριστερή πλευρά και τα R1 και R2 στη δεξιά πλευρά.

Κουμπί

Εντολή

buttonA

controller.buttonA.pressed(callback, arg) — The A button

buttonB

controller.buttonB.pressed(callback, arg) — The B button

buttonDown

controller.buttonDown.pressed(callback, arg) — The Down button

buttonUp

controller.buttonUp.pressed(callback, arg) — The Up button

buttonL1

controller.buttonL1.pressed(callback, arg) — The L1 button

buttonL2

controller.buttonL2.pressed(callback, arg) — The L2 button

buttonL3

controller.buttonL3.pressed(callback, arg) — The L3 button

buttonR1

controller.buttonR1.pressed(callback, arg) — The R1 button

buttonR2

controller.buttonR2.pressed(callback, arg) — The R2 button

buttonR3

controller.buttonR3.pressed(callback, arg) — The R3 button

Παράμετρος

Περιγραφή

callback

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

arg

Προαιρετικό. Μια πλειάδα που περιέχει ορίσματα για να μεταβιβαστούν στη συνάρτηση επανάκλησης. Δείτε Χρήση συμβάντων με παραμέτρους για περισσότερες πληροφορίες.

# Drive forward when R1 is pressed
def drive_forward():
    drivetrain.drive_for(FORWARD, 200, MM)

controller.buttonR1.pressed(drive_forward)

.released#

.released runs a function when the specified button is released. Once it is used, the function will run automatically each time that button is released.

Χρήση:
Ένα από τα διαθέσιμα αντικείμενα κουμπιών μπορεί να χρησιμοποιηθεί με αυτήν τη μέθοδο:

Η μπροστινή και η πάνω πλευρά του χειριστηρίου EXP με τα joystick, τα κουμπιά βέλους και τα κουμπιά δράσης επισημασμένα με κίτρινο χρώμα. Στην επιφάνεια του χειριστηρίου υπάρχουν δύο joystick αριστερά και δεξιά, με κουμπιά βέλους πάνω και κάτω αριστερά και κουμπιά A και B δεξιά. Στο πάνω μέρος του χειριστηρίου βρίσκονται τα L1 και L2 στην αριστερή πλευρά και τα R1 και R2 στη δεξιά πλευρά.

Κουμπί

Εντολή

buttonA

controller.buttonA.released(callback, arg) — The A button

buttonB

controller.buttonB.released(callback, arg) — The B button

buttonDown

controller.buttonDown.released(callback, arg) — The Down button

buttonUp

controller.buttonUp.released(callback, arg) — The Up button

buttonL1

controller.buttonL1.released(callback, arg) — The L1 button

buttonL2

controller.buttonL2.released(callback, arg) — The L2 button

buttonL3

controller.buttonL3.released(callback, arg) — The L3 button

buttonR1

controller.buttonR1.released(callback, arg) — The R1 button

buttonR2

controller.buttonR2.released(callback, arg) — The R2 button

buttonR3

controller.buttonR3.released(callback, arg) — The R3 button

Παράμετρος

Περιγραφή

callback

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

arg

Προαιρετικό. Μια πλειάδα που περιέχει ορίσματα για να μεταβιβαστούν στη συνάρτηση επανάκλησης. Δείτε Χρήση συμβάντων με παραμέτρους για περισσότερες πληροφορίες.

# Stop driving when R1 is released
def stop_driving():
    drivetrain.stop()

controller.buttonR1.released(stop_driving)

.changed#

.changed runs a function when the joystick’s position changes along the specified axis. Once it is used, the function will run automatically each time the joystick’s position changes along that axis.

Χρήση:
Ένα από τα διαθέσιμα αντικείμενα άξονα μπορεί να χρησιμοποιηθεί με αυτήν τη μέθοδο:

Η μπροστινή πλευρά του χειριστηρίου EXP με τους αριθμούς άξονων του joystick επισημασμένους με κόκκινο χρώμα. Στην επιφάνεια του χειριστηρίου, το αριστερό joystick φέρει την ένδειξη Άξονας 4 για κίνηση αριστερά και δεξιά και Άξονας 3 για κίνηση πάνω και κάτω, ενώ το δεξί joystick φέρει την ένδειξη Άξονας 1 για κίνηση αριστερά και δεξιά και Άξονας 2 για κίνηση πάνω και κάτω.

Αξονας

Εντολή

axis1

controller.axis1.changed(callback, arg) — The right joystick’s horizontal axis

axis2

controller.axis2.changed(callback, arg) — The right joystick’s vertical axis

axis3

controller.axis3.changed(callback, arg) — The left joystick’s vertical axis

axis4

controller.axis4.changed(callback, arg) — The left joystick’s horizontal axis

Παράμετρος

Περιγραφή

callback

Μια προηγουμένως καθορισμένη συνάρτηση που θα εκτελείται κάθε φορά που αλλάζει η θέση του joystick κατά μήκος του καθορισμένου άξονα.

arg

Προαιρετικό. Μια πλειάδα που περιέχει ορίσματα για να μεταβιβαστούν στη συνάρτηση επανάκλησης. Δείτε Χρήση συμβάντων με παραμέτρους για περισσότερες πληροφορίες.

# Play a sound when the left joystick moves
def beep():
    brain.play_sound(SoundType.TADA)

controller.axis3.changed(beep)

Κατασκευαστές#

Controller#

Controller creates a Controller object. Manually creating a Controller object is only needed when configuring a controller outside of VEXcode.

Usage:
Controller()

Παράμετροι

Περιγραφή

Αυτός ο κατασκευαστής δεν έχει παραμέτρους.

# Create a Controller object
my_controller = Controller()