Biblioteka kontrolera gier Zawiera Android Game Development Kit.

Biblioteka kontrolera gier, znana również jako Paddleboat, pomaga wdrażać niezawodne dla kontrolerów do gier. Biblioteka obejmuje:

  • Wywołania zwrotne do wykrywania połączeń i rozłączeń kontrolera
  • informacje o urządzeniu kontrolera, w tym o stylu i układzie przycisków;
  • Dane wejściowe kontrolera ustandaryzowane pod kątem nowoczesnego kontrolera z 2 urządzeniami projekty
  • Rozszerzone funkcje na obsługiwanych kontrolerach, w tym wibracje, światła, dane osi ruchu i stan baterii
  • Możliwość odczytywania danych wejściowych z wirtualnych i fizycznych urządzeń myszy
  • Możliwość określenia danych mapowania niestandardowego kontrolera dla konkretnych urządzeń

Wymagania dotyczące zgodności

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

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

Integruj

Biblioteka kontrolera gier jest rozpowszechniana w 2 formatach: jako pakiet Jetpack biblioteka gier korzystających z systemu kompilacji opartego na Gradle (w tym Android Studio), oraz jako osobne pliki w grach z niestandardowymi systemami kompilacji.

Przykład, który integruje bibliotekę kontrolera gier, znajdziesz w games-samples.

Biblioteka Jetpack

Na stronie Jetpack na Androida znajdziesz instrukcje integracji, aby dodać zależność biblioteki kontrolera gier do pliku build.gradle gry.

Wersja kontrolera gier, która działa w bibliotece Jetpack, jest statyczna biblioteka utworzona za pomocą biblioteki współdzielonej środowiska wykonawczego C++.

Po zaktualizowaniu pliku build.gradle musisz dodać następujące elementy do głównego pliku CMakeLists.txt gry:

find_package(games-controller REQUIRED CONFIG)

Do listy bibliotek musisz też dodać tę pozycję w poleceniu target_link_libraries głównego udostępnianego pliku gry biblioteka:

games-controller::paddleboat_static

Pliki dyskretne

Dystrybucja archiwalnej wersji pakietu Android Game Development Kit w wersji .zip obejmuje plików nagłówka i biblioteki kontrolera gier. Następujące pliki musi być uwzględnione w projekcie, aby można było korzystać z biblioteki kontrolera gier:

  • Plik classes.jar zawierający fragmenty kodu bajtowego Dalvik Biblioteka kontrolera gier. Znajdziesz go tutaj: libs/classes.jar
  • Plik nagłówka interfejsu paddleboat.h. Ten plik znajduje się pod adresem include/paddleboat/paddleboat.h
  • Plik biblioteki udostępnionej libpaddleboat.so lub libpaddleboat-static.a plik biblioteki statycznej. Znaleziono te pliki w podkatalogach konfiguracji kompilacji w katalogu libs.

Podkatalogi konfiguracji kompilacji w katalogu głównym libs to uporządkowane według:

  • Architektura ABI
  • Minimalny poziom interfejsu API Androida
  • Wersja NDK Androida
  • Wersja biblioteki środowiska wykonawczego C++
  • Prześlij lub debuguj konfigurację kompilacji

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

  • 64-bitowy ABI ARM
  • Minimalny poziom interfejsu API 16
  • Oparta na NDK w wersji 21
  • Opracowana na podstawie środowiska wykonawczego C++ w wersji z bibliotekami współdzielonymi
  • Konfiguracja kompilacji wersji

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

Dalsze kroki

Aby kontynuować integrację biblioteki kontrolera gier z grą, zapoznaj się z tymi przewodnikami: