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

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

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

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

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

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

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

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

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

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

На странице Jetpack Android Games есть инструкции по интеграции, позволяющие добавить зависимость библиотеки игрового контроллера в файл 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 включает в себя файлы заголовков и библиотеки игрового контроллера. Для использования библиотеки игрового контроллера в ваш проект необходимо включить следующие файлы:

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

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

  • Архитектура ABI
  • Минимальный уровень Android API
  • Версия 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/ в подкаталоге.

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

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