This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Рекомендуется ознакомиться с общим принципом работы ввода в Defold, способами получения ввода и порядком получения ввода в файлах скрипта. Узнайте больше о системе ввода в руководстве.
Триггеры геймпада позволяют связать стандартный ввод геймпада с функциями игры. Для ввода данных с геймпада предусмотрены привязки для:

В приведенных ниже примерах используются действия, показанные на изображении выше. Как и в случае с любым другим вводом, вы можете называть свои действия по своему усмотрению.
Цифровые кнопки генерируют события pressed, released и repeated. Пример обнаружения для цифровой кнопки (нажата или отпущена):
function on_input(self, action_id, action)
if action_id == hash("gamepad_lpad_left") then
if action.pressed then
-- начать движение влево
elseif action.released then
-- прекратить движение влево
end
end
end
Аналоговые стики генерируют непрерывные события ввода, даже, когда стик перемещается за пределы мертвой зоны, заданной в файле настроек геймпада (см. ниже). Пример определения ввода для аналогового стика:
function on_input(self, action_id, action)
if action_id == hash("gamepad_lstick_down") then
-- левый стик перемещён вниз
print(action.value) -- значение между 0.0 и -1.0
end
end
Аналоговые стики также генерируют события pressed и released при перемещении в кардинальных направлениях выше определенного порогового значения. Это позволяет использовать аналоговый стик в качестве цифрового ввода направления:
function on_input(self, action_id, action)
if action_id == hash("gamepad_lstick_down") and action.pressed then
-- левый стик перемещён в крайнее нижнее положение
end
end
Defold поддерживает несколько геймпадов через операционную систему хоста, действия устанавливают поле gamepad в таблице action на номер геймпада, с которого был осуществлен ввод:
function on_input(self, action_id, action)
if action_id == hash("gamepad_start") then
if action.gamepad == 0 then
-- геймпад 0 хочет присоединиться к игре
end
end
end
Привязки ввода геймпада также предоставляют две отдельные привязки с именами Connected и Disconnected для определения того, когда геймпад подключен (даже подключенный с самого начала) или отключен.
function on_input(self, action_id, action)
if action_id == hash("gamepad_connected") then
if action.gamepad == 0 then
-- геймпад 0 подключён
end
elseif action_id == hash("gamepad_disconnected") then
if action.gamepad == 0 then
-- геймпад 0 отключён
end
end
end
Привязки ввода геймпада также предоставляют отдельную привязку с именем Raw для передачи нефильтрованного (без примененной мертвой зоны) ввода кнопок, осей и шляп любого подключенного геймпада.
function on_input(self, action_id, action)
if action_id == hash("raw") then
pprint(action.gamepad_buttons)
pprint(action.gamepad_axis)
pprint(action.gamepad_hats)
end
end
Сопоставления геймпадов преобразуют кнопки, оси и крестовины контроллера в стандартные элементы управления, используемые привязками ввода. Defold объединяет два источника сопоставлений, настраиваемые в разделе Input файла game.project:
| Параметр | Формат сопоставления | По умолчанию |
|---|---|---|
| Gamepad Database | Текстовая база в формате SDL, сопоставление по GUID контроллера | /builtins/input/gamecontrollerdb.txt |
| Gamepads | Прежние записи .gamepads по именам устройств и платформам |
/builtins/input/default.gamepads |
Сопоставления из базы SDL и автоматические сопоставления платформы используют Gamepad Deadzone. Прежние записи .gamepads задают собственные мёртвые зоны. На Android контроллер без записи в базе может также получить автоматическое сопоставление.
Файл .gamepads может содержать сопоставления для нескольких контроллеров. Существующие сопоставления прежнего формата по-прежнему поддерживаются. Defold включает сопоставления для распространённых контроллеров в файле по умолчанию:

Если нужно создать сопоставление прежнего формата .gamepads на настольной платформе, используйте следующий инструмент. Для Android см. Геймпады на Android.
Он включает двоичные файлы для Windows, Linux и macOS. Запустите его из командной строки:
./gdc
Инструмент попросит вас нажать различные кнопки на подключенном контроллере. Затем он выведет новый файл gamepads с правильными отображениями для вашего контроллера. Сохраните новый файл или объедините его с существующим файлом gamepads, затем обновите настройки в game.project:

Если нет ни настроенного сопоставления, ни автоматического сопоставления платформы, геймпад создаёт только действия, привязанные к Connected, Disconnected и Raw. Можно добавить сопоставление контроллера или обрабатывать его необработанный ввод в игре.
Можно проверить, поступает ли входное действие от неопознанного геймпада, прочитав значение gamepad_unknown из action:
function on_input(self, action_id, action)
if action_id == hash("connected") then
if action.gamepad_unknown then
print("The connected gamepad is unidentified and will only generate raw input")
else
print("The connected gamepad is known and will generate input actions for buttons and sticks")
end
end
end
Геймпады поддерживаются в сборках HTML5 и генерируют те же события ввода, что и на других платформах. Поддержка геймпадов основана на Gamepad API, который поддерживается в большинстве браузеров (см. таблицу поддержки). Если браузер не поддерживает Gamepad API, Defold будет молча игнорировать любые триггеры геймпада в вашем проекте. Вы можете проверить, поддерживает ли браузер Gamepad API, проверив, существует ли функция getGamepads для объекта navigator:
local function supports_gamepads()
return not html5 or (html5.run('typeof navigator.getGamepads === "function"') == "true")
end
if supports_gamepads() then
print("Platform supports gamepads")
end
Если ваша игра запускается внутри iframe, вы также должны убедиться, что в iframe добавлено разрешение gamepad:
<iframe allow="gamepad"></iframe>
Если подключённый геймпад определяется браузером как стандартный геймпад, будет использоваться отображение для Standard Gamepad из файла настроек геймпадов (отображение Standard Gamepad включено в файл default.gamepads в каталоге /builtins). Стандартный геймпад определяется как устройство с 16 кнопками и 2 аналоговыми стиками с раскладкой кнопок, аналогичной контроллерам PlayStation или Xbox (см. определение и раскладку кнопок от W3C для получения дополнительной информации). Если подключённый геймпад не определяется как стандартный, Defold будет искать отображение, соответствующее типу аппаратного геймпада в файле настроек геймпада.
В Windows в настоящее время поддерживаются только контроллеры XBox 360. Чтобы подключить контроллер 360 к компьютеру с Windows, убедитесь, что он правильно настроен.
Геймпады поддерживаются в сборках Android и создают те же действия ввода, что и на других платформах. Defold использует настроенные сопоставления геймпадов и может автоматически сопоставлять некоторые контроллеры, для которых нет подходящей записи.
Если контроллер не распознан или его элементы управления работают неверно, протестируйте его на устройстве Android и добавьте либо обновите сопоставление. Для диагностики см. Неопознанные геймпады и Необработанные данные геймпадов.