Библиотека игрового контроллера — часть комплекта разработки игр для Android .

Библиотека Game Controller, также известная как Paddleboat, помогает реализовать надежную поддержку игровых контроллеров. Библиотека Game Controller распространяется как библиотека Jetpack для игр, использующих систему сборки на основе Gradle (включая Android Studio). Библиотека предоставляет следующее:

  • Функции обратного вызова для обнаружения подключений и отключений контроллера.
  • Информация об устройстве контроллера, включая тип и расположение кнопок.
  • Входные данные контроллера, стандартизированные для современных двухджойстиковых контроллеров.
  • Расширенные функции поддерживаемых контроллеров, включая вибрацию, подсветку, данные об осях движения и состояние батареи.
  • Возможность считывать ввод с виртуальных и физических мыши.
  • Возможность указывать пользовательские данные сопоставления контроллера для конкретных устройств.

Требования к совместимости

Библиотека Game Controller имеет минимальные требования к совместимости:

  • Android 4.4 (уровень API 19) или выше
  • Android NDK версии 21 или выше

Интегрировать

На странице Jetpack Android Games приведены инструкции по интеграции, позволяющие добавить зависимость библиотеки Game Controller в файл build.gradle вашей игры.

Библиотека Game Controller, выпущенная в рамках проекта Jetpack, представляет собой статическую библиотеку, собранную на основе разделяемой библиотеки среды выполнения C++.

После обновления файла build.gradle вам потребуется добавить следующую строку в основной файл CMakeLists.txt вашей игры:

find_package(games-controller REQUIRED CONFIG)

Вам также потребуется добавить следующую запись в список библиотек в команде target_link_libraries основной разделяемой библиотеки вашей игры:

games-controller::paddleboat_static

Пример использования библиотеки Game Controller можно найти в репозитории games-samples .

Следующие шаги

Для дальнейшей интеграции библиотеки Game Controller в вашу игру ознакомьтесь со следующими руководствами: