Нажатие кнопки контроллера (:down)

Этот метод доступен только в версиях после 20260805.

Объявление

состояние, сообщение_об_ошибке = объект_контроллера:down(кнопка)

Параметры

• кнопка Целое число или текст: можно передать целое число от 1 до 32, имя кнопки из таблицы ниже либо "start" или "menu"; регистр строки не учитывается.

Номер	Имя кнопки	Псевдонимы
1	a	-
2	b	-
3	x	-
4	y	-
5	left_shoulder	left_bumper、lb、l1
6	right_shoulder	right_bumper、rb、r1
7	left_trigger	lt、l2
8	right_trigger	rt、r2
9	left_stick	l3
10	right_stick	r3
11	l4	left_paddle
12	r4	right_paddle
13	m1	-
14	m2	-
15	m3	-
16	m4	-

Возвращаемые значения

• состояние Логическое значение: true при успешной операции и false, если устройство отключено, занято или отправка ввода завершилась ошибкой.
• сообщение об ошибке Текст с описанием ошибки операции.

Описание

• Числа 1–32 обозначают цифровые кнопки, а не единый для всех устройств код игровой кнопки; обычно следует отдавать предпочтение именам из таблицы выше.
• Для чисел 17–32 нет предопределённых имён; они работают только при поддержке соответствующих расширенных кнопок целевым приложением.
• "start" и "menu" — псевдонимы одного и того же меню ввода, они не соответствуют какому-либо числу от 1 до 32.
• Имена кнопок select, back, options, home, share и кнопки трекпада пока не поддерживаются.
• left_trigger и right_trigger поддерживают только нажатие и отпускание, но не имитацию значения давления; menu не запускает действие системного домашнего экрана.
• Ошибки типа параметра, неизвестные имена и значения вне диапазона вызывают ошибку параметров Lua, а не возвращают false, error.

Пример

local pad = assert(gamepad.connect())

assert(pad:down("left_shoulder"))
assert(pad:up("left_shoulder"))
assert(pad:down(13))  -- Цифровая кнопка 13.
assert(pad:up(13))
assert(pad:disconnect())