# Объект «gamepad»

Служит для работы с программируемым пультом управления «[TRIK Gamepad](/gamepad/about.md)».

| Метод                                                                         | Описание                                                                                                             |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| [buttonWasPressed](/trik/programming-code/object-gamepad.md#buttonwaspressed) | Возвращает `true`, если на пульте была нажата кнопка с указанным номером.                                            |
| [isPadPressed](/trik/programming-code/object-gamepad.md#ispadpressed)         | Возвращает, нажата ли в данный момент область управления на пульте.                                                  |
| [padX](/trik/programming-code/object-gamepad.md#padx)                         | Если указанная область управления на пульте нажата, возвращает текущую координату нажатия по оси X.                  |
| [padY](/trik/programming-code/object-gamepad.md#pady)                         | Если указанная область управления на пульте нажата, возвращает текущую координату нажатия по оси Y.                  |
| [padUp](/trik/programming-code/object-gamepad.md#padup)                       | Посылается, когда пользователь оторвал палец от области управления с указанным номером.                              |
| [reset](/trik/programming-code/object-gamepad.md#reset)                       | Сбрасывает запомненные события от пульта.                                                                            |
| [wheel](/trik/programming-code/object-gamepad.md#wheel)                       | Если на пульте включён «руль» (события от акселерометра устройства), возвращает текущий наклон пульта.               |
| [wheelEvent](/trik/programming-code/object-gamepad.md#wheelevent)             | Посылается, когда на пульте включён «руль» (события от акселерометра устройства) и пользователь повернул устройство. |

| Сигнал                                                            | Описание                                                                                          |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [button](/trik/programming-code/object-gamepad.md#button)         | Посылается, когда пользователь нажал на одну из пяти кнопок внизу пульта.                         |
| [connected](/trik/programming-code/object-gamepad.md#connected)   | Посылается при подключении пульта к роботу.                                                       |
| [disconnect](/trik/programming-code/object-gamepad.md#disconnect) | Посылается при отключении пульта.                                                                 |
| [pad](/trik/programming-code/object-gamepad.md#pad)               | Посылается, когда пользователь нажал на область управления на пульте или переместил палец по ней. |

## button

Посылается, когда пользователь нажал на одну из пяти кнопок внизу пульта.

## buttonWasPressed

Возвращает `true`, если на пульте была нажата кнопка с указанным номером. Сбрасывает запомненное нажатие для этой кнопки.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.buttonWasPressed(buttonNumber)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.buttonWasPressed(buttonNumber);
```

{% endtab %}
{% endtabs %}

В качестве параметра необходимо указать номер кнопки — от 1 до 5.

#### Пример

{% tabs %}
{% tab title="Python" %}

```python
gamepad.buttonWasPressed(5)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.buttonWasPressed(5);
```

{% endtab %}
{% endtabs %}

## connected

Посылается при подключении пульта к роботу.

## disconnect

Посылается при отключении пульта.

## isPadPressed

Возвращает, нажата ли в данный момент область управления на пульте. Области управления имеют номера 0 и 1.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.isPadPressed(padId)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.isPadPressed(padId);
```

{% endtab %}
{% endtabs %}

В качестве параметра необходимо указать номер области управления — 0 или 1.

#### Пример

{% tabs %}
{% tab title="Python" %}

```python
gamepad.isPadPressed(1)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.isPadPressed(1);
```

{% endtab %}
{% endtabs %}

## pad

Посылается, когда пользователь нажал на область управления на пульте или переместил палец по ней.

## padX

Если указанная область управления на пульте нажата, возвращает текущую x-координату нажатия.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.padX(padId)
```

{% endtab %}

{% tab title="JavaScript" %}

```
gamepad.padX(padId);
```

{% endtab %}
{% endtabs %}

В качестве параметра необходимо указать — номер области управления `padId`*.*

## padY

Если указанная область управления на пульте нажата, возвращает текущую y-координату нажатия.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.padY(padId)
```

{% endtab %}

{% tab title="JavaScript" %}

```
gamepad.padY(padId);
```

{% endtab %}
{% endtabs %}

В качестве параметра необходимо указать — номер области управления `padId`*.*

## padUp

Посылается, когда пользователь оторвал палец от области управления с указанным номером.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```python
gamepad.padUp.connect(lambda padId, x, y: brick.stop())
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.padUp.connect( function(padId, x, y) { brick.stop(); });
```

{% endtab %}
{% endtabs %}

В качестве параметров необходимо указать:

* `padId` — номер области управления.
* `x`, `y` — координаты последнего известного нажатия от -100 до 100. Координата (-100, -100) соответствует левому верхнему углу области управления.

## reset

Сбрасывает запомненные события от пульта.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.reset()
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.reset();
```

{% endtab %}
{% endtabs %}

## wheel

Если на пульте включён «руль» (события от акселерометра устройства), возвращает текущий наклон пульта.

Наклон кодируется числом от -100 до 100, -100 соответствует крайнему левому положению «руля», 100 — крайнему правому.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
gamepad.wheel()
```

{% endtab %}

{% tab title="JavaScript" %}

```
gamepad.wheel();
```

{% endtab %}
{% endtabs %}

## wheelEvent

Посылается, когда на пульте включён «руль» (события от акселерометра устройства) и пользователь повернул устройство.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```python
gamepad.wheelEvent.connect(lambda percent: brick.motor("E1").setPower(percent))
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
gamepad.wheelEvent.connect(function(percent) { brick.motor("E1").setPower(percent); });
```

{% endtab %}
{% endtabs %}

В качестве параметра необходимо указать число от -100 до 100, -100 соответствует крайнему левому положению «руля», 100 — крайнему правому.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.trikset.com/trik/programming-code/object-gamepad.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.