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.4 (poziom interfejsu API 19) lub nowszy
- Android NDK w wersji 21 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 bibliotekilibpaddleboat-static.a
. Pliki te można znaleźć w podkatalogach konfiguracji kompilacji w katalogulibs
.
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ą:
- Korzystanie z biblioteki kontrolera gier
- Dodaj obsługę myszy
- Dodawanie niestandardowych mapowań urządzeń kontrolera