Поддержка геймпада

Обновлено 19 февраля 2025

Native App

Вы можете настроить поддержку геймпада для навигации в Native App. Геймпад можно использовать как замену физического или виртуального пульта.

Вы можете настроить поддержку виртуального геймпада для вашего Native App. Виртуальный геймпад дублирует функциональность аналогового геймпада и виртуального пульта.

Обработка событий

Когда пользователь использует геймпад, ОС устройства передает следующие события:

• При нажатии кнопок передаются события, аналогичные событиям KeyEvent в Android.
• При нажатии курков или использовании стиков передаются события, аналогичные событиям MotionEvent в Android.

Чтобы обрабатывать эти типы событий:

• Переопределите колбэк [onKeyDown](https://developer.android.com/reference/android/view/KeyEvent.Callback?hl=en#onKeyDown(int,%20android.view.KeyEvent) для регистрации событий типа KeyEvent.
• Реализуйте метод [onGenericMotionEvent](https://developer.android.com/reference/android/view/View#onGenericMotionEvent(android.view.MotionEvent) для регистрации событий типа MotionEvent.

События нажатия кнопок

Кнопка на геймпаде	Код нажатия клавиши на клавиатуре Android
A	KeyEvent.KEYCODE_BUTTON_A = 96;
B	KeyEvent.KEYCODE_BUTTON_B = 97; KeyEvent.KEYCODE_BACK = 4;
X	KeyEvent.KEYCODE_BUTTON_X = 99; KeyEvent.KEYCODE_DEL = 67;
Y	KeyEvent.KEYCODE_BUTTON_Y = 100; KeyEvent.KEYCODE_SPACE = 62;
Left	KeyEvent.KEYCODE_DPAD_LEFT = 21; MotionEvent.ACTION_MOVE AXIS_HAT_X -1.0 принимает значение 0 или -1.
Right	KeyEvent.KEYCODE_DPAD_RIGHT = 22; MotionEvent.ACTION_MOVE AXIS_HAT_X 1.0 принимает значение 0 или 1.
Up	KeyEvent.KEYCODE_DPAD_UP = 19; MotionEvent.ACTION_MOVE AXIS_HAT_Y -1.0 принимает значение 0 или -1.
Down	KeyEvent.KEYCODE_DPAD_DOWN = 20; MotionEvent.ACTION_MOVE AXIS_HAT_Y 1.0 принимает значение 0 или 1.
RB	KeyEvent.KEYCODE_BUTTON_R1 = 103;
LB	KeyEvent.KEYCODE_BUTTON_L1 = 102;
RT	KeyEvent.KEYCODE_BUTTON_R2 = 105;
LT	KeyEvent.KEYCODE_BUTTON_L2 = 104; MotionEvent.ACTION_MOVE AXIS_BRAKE принимает значение 0 или 1.
Left Stick	Отклонение стика: KeyEvent.KEYCODE_DPAD_UP = 19; KeyEvent.KEYCODE_DPAD_DOWN = 20; KeyEvent.KEYCODE_DPAD_LEFT = 21; KeyEvent.KEYCODE_DPAD_RIGHT = 22; Клик по стику: KeyEvent.KEYCODE_BUTTON_THUMBL = 106; KeyEvent.KEYCODE_DPAD_CENTER = 23; MotionEvent.ACTION_MOVE AXIS_X принимает значение от -1 до 1. AXIS_Y принимает значение от -1 до 1.
Right Stick	Клик по стику: KeyEvent.KEYCODE_BUTTON_THUMBR = 107; KeyEvent.KEYCODE_DPAD_CENTER = 23; MotionEvent.ACTION_MOVE AXIS_Z принимает значение от -1 до 1. AXIS_RZ принимает значение от -1 до 1.
Гироскоп	KeyEvent.KEYCODE_DPAD_LEFT = 21; KEYCODE_DPAD_RIGHT = 22; MotionEvent.ACTION_MOVE AXIS_X принимает значение от -1 до 1.

Виртуальный геймпад не имеет плавного хода триггеров и управления осями AXIS_RTRIGGER, AXIS_LTRIGGER и AXIS_THROTTLE.