Controlador#

Introducción #

El Brain IQ (2.ª generación) se puede conectar a un mando IQ (2.ª generación) o a un mando IQ (1.ª generación). Ambos mandos cuentan con dos joysticks analógicos y varios botones que el Brain puede usar para detectar movimientos y pulsaciones.

For the examples below, the configured Distance Sensors will be named Controller, and will be used in all subsequent examples throughout this API documentation when referring to Controller class methods.

A continuación se muestra una lista de los métodos disponibles:

Acciones: habilitar o deshabilitar el controlador.

RemoteControlCodeEnabled – Habilita o deshabilita las acciones configuradas del controlador.

Getters: devuelven valores de los joysticks y botones del controlador.

pressing – Devuelve si se está presionando el botón especificado.
posición – Devuelve la posición del eje especificado del joystick.

Devolución de llamada: interactúa con el controlador a través de métodos de devolución de llamada.

presionado – Llama a una función cuando se presiona el botón especificado.
liberado – Llama a una función cuando se suelta el botón especificado.
cambiado – Llama a una función cuando cambia el eje del joystick.

Constructores: inicializan manualmente el controlador.

controlador – Crea un controlador.

Comportamiento #

RemoteControlCodeEnabled #

RemoteControlCodeEnabled is a variable that can be set to a Boolean that enables or disables Controller configured actions from the Devices menu. The controller is enabled by default. It can be set to either of the following:

true — Enable Controller configured actions.
false — Disable Controller configured actions.

Usage:
RemoteControlCodeEnabled = false;

// Example coming soon

Captadores #

pressing #

pressing returns an integer indicating whether a specific button on the controller is currently being pressed. This method must be called on a specific button object, such as ButtonEDown (see full list of button objects below).

1 - The specified button is being pressed.
0 - The specified button is not being pressed.

Uso:
Se puede usar uno de los diez objetos de botón disponibles con este método, como se muestra a continuación:

Botón	Dominio
`ButtonEDown`	`Controller.ButtonEDown.pressing()` — The E Down button
`ButtonEUp`	`Controller.ButtonEUp.pressing()` — The E Up button
`ButtonFDown`	`Controller.ButtonFDown.pressing()` — The F Down button
`ButtonFUp`	`Controller.ButtonFUp.pressing()` — The F Up button
`ButtonL3`	`Controller.ButtonL3.pressing()` — The Left Joystick button IQ (2nd gen) Controller only
`ButtonLDown`	`Controller.ButtonLDown.pressing()` — The L Down button
`ButtonLUp`	`Controller.ButtonLUp.pressing()` — The L Up button
`ButtonR3`	`Controller.ButtonR3.pressing()` — The Right Joystick button IQ (2nd gen) Controller only
`ButtonRDown`	`Controller.ButtonRDown.pressing()` — The R Down button
`ButtonRUp`	`Controller.ButtonRUp.pressing()` — The R Up button

Parámetros	Descripción
	Este método no tiene parámetros.

// Example coming soon

position #

position returns the position of the joystick’s specified axis as an integer from –100 to 100, representing a percentage. This method must be called on a specific axis object, such as AxisA (see full list of axis objects below).

Uso:
Se puede utilizar uno de los cuatro ejes disponibles con este método, como se muestra a continuación:

Eje	Dominio
`AxisA`	`Controller.AxisA.position()` — The Left Joystick’s vertical axis
`AxisB`	`Controller.AxisB.position()` — The Left Joystick’s horizontal axis
`AxisC`	`Controller.AxisC.position()` — The Right Joystick’s horizontal axis
`AxisD`	`Controller.AxisD.position()` — The Right Joystick’s vertical axis

Parámetros	Descripción
	Este método no tiene parámetros.

// Example coming soon

Llamar de vuelta #

pressed #

pressed registers a function to be called when a specific button on the controller is pressed. This method must be called on a specific button object, such as ButtonEDown – (see full list of button objects below).

Uso:
Se puede usar uno de los diez objetos de botón disponibles con este método, como se muestra a continuación:

Botón	Dominio
`ButtonEDown`	`Controller.ButtonEDown.pressed(callback);` — The E Down button
`ButtonEUp`	`Controller.ButtonEUp.pressed(callback);` — The E Up button
`ButtonFDown`	`Controller.ButtonFDown.pressed(callback);` — The F Down button
`ButtonFUp`	`Controller.ButtonFUp.pressed(callback);` — The F Up button
`ButtonL3`	`Controller.ButtonL3.pressed(callback);` — The Left Joystick button IQ (2nd gen) Controller only
`ButtonLDown`	`Controller.ButtonLDown.pressed(callback);` — The L Down button
`ButtonLUp`	`Controller.ButtonLUp.pressed(callback);` — The L Up button
`ButtonR3`	`Controller.ButtonR3.pressed(callback);` — The Right Joystick button IQ (2nd gen) Controller only
`ButtonRDown`	`Controller.ButtonRDown.pressed(callback);` — The R Down button
`ButtonRUp`	`Controller.ButtonRUp.pressed(callback);` — The R Up button

Parámetro	Descripción
`callback`	La función de devolución de llamada que se llamará cuando se presione el botón especificado.

// Example coming soon

released #

released registers a function to be called when a specific button on the controller is released. This method must be called on a specific button object, such as ButtonEDown – (see full list of button objects below).

Uso:
Se puede usar uno de los diez objetos de botón disponibles con este método, como se muestra a continuación:

Botón	Dominio
`ButtonEDown`	`Controller.ButtonEDown.released(callback);` — The E Down button
`ButtonEUp`	`Controller.ButtonEUp.released(callback);` — The E Up button
`ButtonFDown`	`Controller.ButtonFDown.released(callback);` — The F Down button
`ButtonFUp`	`Controller.ButtonFUp.released(callback);` — The F Up button
`ButtonL3`	`Controller.ButtonL3.released(callback);` — The Left Joystick button IQ (2nd gen) Controller only
`ButtonLDown`	`Controller.ButtonLDown.released(callback);` — The L Down button
`ButtonLUp`	`Controller.ButtonLUp.released(callback);` — The L Up button
`ButtonR3`	`Controller.ButtonR3.released(callback);` — The Right Joystick button IQ (2nd gen) Controller only
`ButtonRDown`	`Controller.ButtonRDown.released(callback);` — The R Down button
`ButtonRUp`	`Controller.ButtonRUp.released(callback);` — The R Up button

Parámetro	Descripción
`callback`	La función de devolución de llamada que se llamará cuando se suelte el botón especificado.

// Example coming soon

changed #

changed registers a function to be called when the joystick’s position changes. This method must be called on a specific axis object, such as AxisA (see full list of axis objects below).

Uso:
Se puede utilizar uno de los cuatro ejes disponibles con este método, como se muestra a continuación:

Eje	Dominio
`AxisA`	`Controller.AxisA.changed(callback);` — The Left Joystick’s vertical axis
`AxisB`	`Controller.AxisB.changed(callback);` — The Left Joystick’s horizontal axis
`AxisC`	`Controller.AxisC.changed(callback);` — The Right Joystick’s horizontal axis
`AxisD`	`Controller.AxisD.changed(callback);` — The Right Joystick’s vertical axis

Parámetros	Descripción
`callback`	La función de devolución de llamada que se llamará cuando cambie la posición del eje especificado.

// Example coming soon

Constructores #

controller #

controller creates a controller object.

Usage:
controller Controller = controller();

Parámetro	Descripción
	Este método no tiene parámetros.

// Example coming soon