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

Библиотека игровых контроллеров, также известная как Paddleboat, помогает реализовать надежную поддержку игровых контроллеров. Она предоставляет следующие возможности:

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

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

Минимальные требования к совместимости библиотеки игровых контроллеров:

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

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

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

Пример, интегрирующий библиотеку игрового контроллера, можно найти в репозитории games-samples .

Библиотека реактивного ранца

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

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

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

find_package(games-controller REQUIRED CONFIG)

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

games-controller::paddleboat_static

Отдельные файлы

Дистрибутив .zip -архива Android Game Development Kit включает заголовочные файлы и файлы библиотеки для игрового контроллера. Для использования библиотеки игрового контроллера в ваш проект необходимо включить следующие файлы:

  • Файл classes.jar , содержащий фрагменты байт-кода Dalvik библиотеки игрового контроллера. Этот файл находится по адресу libs/classes.jar
  • Заголовочный файл интерфейса paddleboat.h . Этот файл расположен по адресу include/paddleboat/paddleboat.h
  • Файл общей библиотеки libpaddleboat.so или файл статической библиотеки libpaddleboat-static.a . Эти файлы находятся в подкаталогах конфигурации сборки каталога libs .

Подкаталоги конфигурации сборки в корневом каталоге libs классифицируются по:

  • Архитектура ABI
  • Минимальный уровень API Android
  • Версия Android NDK
  • Версия библиотеки времени выполнения C++
  • Конфигурация сборки выпуска или отладки

Например, подкаталог arm64-v8a_API16_NDK21_cpp_shared_Release содержит файлы библиотеки для:

  • ARM 64-битный ABI
  • Минимальный уровень API 16
  • Создано на основе NDK версии 21
  • Создано на основе версии общей библиотеки среды выполнения C++
  • Конфигурация сборки релиза

Файл libpaddleboat_static.a находится непосредственно в подкаталоге. Файл libpaddleboat.so находится в каталоге lib/paddleboat/ того же подкаталога.

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

Чтобы продолжить интеграцию библиотеки игровых контроллеров в вашу игру, ознакомьтесь со следующими руководствами: