Biblioteka kontrolera do gier   Część Android Game Development Kit.

Biblioteka Game Controller, znana też jako Paddleboat, pomaga w zapewnieniu solidnej obsługi kontrolerów do gier. Biblioteka zapewnia:

  • Wywołania zwrotne do wykrywania podłączenia i odłączenia kontrolera
  • Informacje o kontrolerze, w tym styl i układ przycisków.
  • Dane wejściowe kontrolera, ustandaryzowane pod kątem nowoczesnych kontrolerów z dwoma drążkami
  • Rozszerzone funkcje na obsługiwanych kontrolerach, w tym wibracje, światła, dane osi ruchu i stan baterii
  • Możliwość odczytu danych wejściowych z wirtualnych i fizycznych urządzeń wskazujących
  • Możliwość określania niestandardowych danych mapowania kontrolera dla konkretnych urządzeń

Wymagania dotyczące zgodności

Biblioteka Game Controller ma minimalne wymagania dotyczące zgodności:

  • Android 4.4 (poziom 19 interfejsu API) lub nowszy
  • Android NDK w wersji 21 lub nowszej.

Integracja

Biblioteka Game Controller jest rozpowszechniana w 2 formatach: jako biblioteka Jetpack dla gier korzystających z systemu kompilacji opartego na Gradle (w tym Android Studio) oraz jako osobne pliki dla gier korzystających z niestandardowych systemów kompilacji.

Przykładowy projekt, który integruje bibliotekę Game Controller, znajdziesz w repozytorium games-samples.

Biblioteka Jetpack

Na stronie Jetpack Android Games znajdziesz instrukcje integracji, które pomogą Ci dodać zależność biblioteki Game Controller do pliku build.gradle gry.

Biblioteka Jetpack Game Controller to statyczna biblioteka zbudowana na podstawie biblioteki współdzielonej środowiska wykonawczego C++.

Po zaktualizowaniu pliku build.gradle musisz dodać do głównego pliku CMakeLists.txt gry ten wiersz:

find_package(games-controller REQUIRED CONFIG)

Musisz też dodać ten wpis do listy bibliotek w poleceniu target_link_libraries głównej biblioteki współdzielonej gry:

games-controller::paddleboat_static

osobne pliki,

Dystrybucja archiwum .zip Android Game Development Kit zawiera pliki nagłówkowe i biblioteczne biblioteki Game Controller. Aby korzystać z biblioteki Game Controller, w projekcie muszą się znajdować te pliki:

  • Plik classes.jar zawierający części biblioteki Game Controller w postaci kodu bajtowego Dalvik. Ten plik znajduje się w lokalizacji libs/classes.jar
  • Plik nagłówkowy interfejsu paddleboat.h. Ten plik znajduje się w lokalizacji:include/paddleboat/paddleboat.h
  • Plik biblioteki współdzielonej libpaddleboat.so lub plik biblioteki statycznej libpaddleboat-static.a. Pliki te znajdują się w podkatalogach konfiguracji kompilacji w katalogu libs.

Podkatalogi konfiguracji kompilacji w katalogu głównym libs są podzielone na kategorie według:

  • Architektura interfejsu ABI
  • Minimalny poziom interfejsu API Androida
  • Wersja Android NDK
  • Wersja biblioteki środowiska wykonawczego C++
  • Konfiguracja kompilacji do publikacji lub debugowania

Na przykład podkatalog arm64-v8a_API16_NDK21_cpp_shared_Release zawiera pliki biblioteki dla:

  • 64-bitowy interfejs ABI ARM
  • Minimalny poziom interfejsu API 16
  • Utworzono na podstawie wersji 21 NDK
  • Zbudowana na podstawie wersji biblioteki udostępnionej środowiska wykonawczego C++
  • Konfiguracja kompilacji do publikacji

Plik libpaddleboat_static.a znajduje się bezpośrednio w podkatalogu. Plik libpaddleboat.so znajduje się w podkatalogu lib/paddleboat/.

Dalsze kroki

Aby kontynuować integrację biblioteki Game Controller z grą, zapoznaj się z tymi przewodnikami: