Biblioteka kontrolerów gier Część pakietu Android Game Development Kit.

Biblioteka kontrolerów gier, zwana także Paddleboat, pomaga wdrożyć niezawodną obsługę kontrolerów do gier. Biblioteka udostępnia te funkcje:

  • Wywołania zwrotne umożliwiające wykrywanie połączeń i rozłączenia kontrolera
  • informacje o urządzeniu kontrolera, w tym styl i układ przycisków;
  • Dane wejściowe kontrolera ujednolicone pod kątem nowoczesnych kontrolerów dual-stick
  • Rozszerzone funkcje dostępne 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 myszy
  • Możliwość określania niestandardowych danych mapowania kontrolera dla konkretnych urządzeń

Wymagania dotyczące zgodności

Biblioteka kontrolera gier ma minimalne wymagania dotyczące zgodności:

  • Android 4.1 (poziom interfejsu API 16) lub nowszy
  • Android NDK w wersji 17 lub nowszej.

Integracja

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

Przykład integrujący bibliotekę kontrolera gier znajdziesz w repozytorium przykładów gier.

Biblioteka Jetpacka

Na stronie Gry Jetpack na Androida znajdziesz instrukcje integracji pozwalające dodać zależność biblioteki kontrolera gier do pliku build.gradle gry.

Wersja kontrolera gier dostępna w bibliotece Jetpack to biblioteka statyczna zbudowana na podstawie udostępnionej biblioteki środowiska wykonawczego C++.

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

find_package(games-controller REQUIRED CONFIG)

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

games-controller::paddleboat_static

Oddzielne pliki

Dystrybucja archiwum pakietu Android Game Development Kit w .zip obejmuje pliki nagłówka i biblioteki biblioteki kontrolera gier. Aby można było korzystać z biblioteki kontrolera gier, projekt musi zawierać te pliki:

  • Plik classes.jar zawierający fragmenty kodu bajtowego Dalvik z biblioteki kontrolera gier. Ten plik znajduje się w: libs/classes.jar
  • Plik nagłówka interfejsu paddleboat.h. Ten plik znajduje się w: include/paddleboat/paddleboat.h
  • Plik biblioteki udostępnionej libpaddleboat.so lub statyczny plik biblioteki libpaddleboat-static.a. Pliki te można znaleźć w podkatalogach konfiguracji kompilacji w katalogu libs.

Podkatalogi konfiguracji kompilacji w głównym katalogu libs są klasyfikowane według tych kategorii:

  • Architektura interfejsu ABI
  • Minimalny poziom interfejsu Android API
  • Wersja Androida NDK
  • Wersja biblioteki środowiska wykonawczego C++
  • Publikowanie lub debugowanie konfiguracji kompilacji

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

  • 64-bitowy interfejs ABI dla ARM
  • Minimalny poziom API 16
  • Zbudowane na podstawie pakietu NDK w wersji 21
  • Utworzono na podstawie środowiska wykonawczego C++ z biblioteką udostępnianą
  • Konfiguracja kompilacji wersji

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

Dalsze kroki

Zapoznaj się z poniższymi przewodnikami, aby kontynuować integrację biblioteki kontrolera gier z grą: