Controller#

Introducción #

The IQ (2nd gen) Brain can connect to either an IQ (2nd gen) or IQ (1st gen) Controller. Both controllers have two analog joysticks and multiple buttons that the Brain can use to detect movements and presses.

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 #

Código de control remoto habilitado #

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 — Habilita las acciones configuradas del controlador.
false — Deshabilitar las acciones configuradas del controlador.

Usage:
RemoteControlCodeEnabled = false;

// Example coming soon

Captadores #

prensado #

pressing devuelve un entero que indica si un botón específico del controlador está presionado. Este método debe llamarse en un objeto de botón específico, como ButtonEDown (consulte la lista completa de objetos de botón a continuación).

1 - Se está presionando el botón especificado.
0 - No se está presionando el botón especificado.

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
`Botón Abajo`	`Controller.ButtonEDown.pressing()` — El botón E Abajo
Botón Arriba	`Controller.ButtonEUp.pressing()` — El botón E Arriba
`Botón Abajo`	`Controller.ButtonFDown.pressing()` — El botón F Abajo
`BotónFUp`	`Controller.ButtonFUp.pressing()` — El botón F Arriba
`BotónL3`	`Controller.ButtonL3.pressing()` — The Left Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonLDown.pressing()` — El botón L Abajo
`ButtonLUr`	`Controller.ButtonLUp.pressing()` — El botón L Arriba
`BotónR3`	`Controller.ButtonR3.pressing()` — The Right Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonRDown.pressing()` — El botón R Abajo
`Botón R Up`	`Controller.ButtonRUp.pressing()` — El botón R Arriba

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

// Example coming soon

posición #

position devuelve la posición del eje especificado del joystick como un entero entre -100 y 100, que representa un porcentaje. Este método debe llamarse en un objeto de eje específico, como AxisA (consulte la lista completa de objetos de eje a continuación).

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

Eje	Dominio
Eje A	`Controller.AxisA.position()` — El eje vertical del Joystick izquierdo
Eje B	`Controller.AxisB.position()` — El eje horizontal del Joystick izquierdo
`Eje C`	`Controller.AxisC.position()` — El eje horizontal del Joystick derecho
`Eje D`	`Controller.AxisD.position()` — El eje vertical del Joystick derecho

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

// Example coming soon

Llamar de vuelta #

apretado #

pressed registra una función que se llamará al presionar un botón específico del controlador. Este método debe llamarse en un objeto de botón específico, como ButtonEDown (ver la lista completa de objetos de botón a continuación).

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
`Botón Abajo`	`Controller.ButtonEDown.pressed(callback);` — The E Down button
Botón Arriba	`Controller.ButtonEUp.pressed(callback);` — The E Up button
`Botón Abajo`	`Controller.ButtonFDown.pressed(callback);` — The F Down button
`BotónFUp`	`Controller.ButtonFUp.pressed(callback);` — The F Up button
`BotónL3`	`Controller.ButtonL3.pressed(callback);` — The Left Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonLDown.pressed(callback);` — The L Down button
`ButtonLUr`	`Controller.ButtonLUp.pressed(callback);` — The L Up button
`BotónR3`	`Controller.ButtonR3.pressed(callback);` — The Right Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonRDown.pressed(callback);` — The R Down button
`Botón R Up`	`Controller.ButtonRUp.pressed(callback);` — The R Up button

Parámetro	Descripción
`callback`	The callback function to be called when the specified button is pressed.

// Example coming soon

liberado #

released registra una función que se llamará al soltar un botón específico del controlador. Este método debe llamarse en un objeto de botón específico, como ButtonEDown (ver la lista completa de objetos de botón a continuación).

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
`Botón Abajo`	`Controller.ButtonEDown.released(callback);` — The E Down button
Botón Arriba	`Controller.ButtonEUp.released(callback);` — The E Up button
`Botón Abajo`	`Controller.ButtonFDown.released(callback);` — The F Down button
`BotónFUp`	`Controller.ButtonFUp.released(callback);` — The F Up button
`BotónL3`	`Controller.ButtonL3.released(callback);` — The Left Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonLDown.released(callback);` — The L Down button
`ButtonLUr`	`Controller.ButtonLUp.released(callback);` — The L Up button
`BotónR3`	`Controller.ButtonR3.released(callback);` — The Right Joystick button IQ (2nd gen) Controller only
`Botón Abajo`	`Controller.ButtonRDown.released(callback);` — The R Down button
`Botón R Up`	`Controller.ButtonRUp.released(callback);` — The R Up button

Parámetro	Descripción
`callback`	The callback function to be called when the specified button is released.

// Example coming soon

cambió #

changed registra una función que se llamará cuando cambie la posición del joystick. Este método debe llamarse en un objeto de eje específico, como AxisA (consulte la lista completa de objetos de eje a continuación).

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

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

Parámetros	Descripción
`callback`	The callback function to be called when the specified axis’s position changes.

// Example coming soon

Constructores #

controlador #

controller crea un objeto controlador.

Usage:
controller Controller = controller();

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

// Example coming soon