GameActivity Jest częścią Android Game Development Kit.
GameActivity to biblioteka Jetpack, która pomaga grom w języku C/C++ na Androida przetwarzać polecenia cyklu aplikacji, zdarzenia wejściowe i wprowadzany tekst. GameActivity jest bezpośrednim potomkiem NativeActivity i ma podobną architekturę:

Jak pokazano na diagramie powyżej, GameActivity wykonuje te funkcje:
- Interakcja z platformą Androida za pomocą komponentu po stronie Javy.
- Przekazywanie poleceń cyklu aplikacji, zdarzeń wejściowych i tekstu wejściowego do strony natywnej.
- Modelowanie kodu źródłowego C/C++ w 3 komponentach logicznych:
- Funkcje JNI GameActivity, które bezpośrednio obsługują funkcje Javy GameActivity i dodają zdarzenia do kolejki
native_app_glue. native_app_glue, który działa głównie we własnym wątku natywnym (innym niż główny wątek aplikacji) i wykonuje zadania za pomocą pętli.- Kod gry aplikacji, który odpytuje i przetwarza zdarzenia umieszczone w kolejce w
native_app_glueoraz wykonuje kod gry w wątkunative_app_glue.
- Funkcje JNI GameActivity, które bezpośrednio obsługują funkcje Javy GameActivity i dodają zdarzenia do kolejki
Dzięki GameActivity możesz skupić się na tworzeniu gry i nie marnować czasu na kod JNI.
Jeśli znasz już NativeActivity, oto główne różnice między GameActivity a NativeActivity:
GameActivityrenderuje się wSurfaceView, co znacznie ułatwia grom interakcję z innymi komponentami interfejsu.- W przypadku zdarzeń dotknięcia i wprowadzania danych za pomocą klawiszy
GameActivityma zupełnie nową implementację z interfejsemandroid_input_buffer, oddzielnym odInputQueue, którego używaNativeActivity. GameActivityjest klasą pochodnąAppCompatActivity, która umożliwia bezproblemowe korzystanie z innych komponentów Jetpack.ActionBar,Fragmenti inne.GameActivitydodaje funkcję wprowadzania tekstu przez integrację biblioteki GameTextInput.- Aplikacje pochodzące z
GameActivitypowinny kompilować wszystkie 3 części kodu C/C++ w jedną bibliotekę. Z drugiej strony funkcje JNINativeActivitysą częścią platformy (zawsze wczytywanej przez system operacyjny). Dlatego tylkonative_app_gluei kod C/C++ aplikacji powinny być kompilowane do jednej biblioteki. NativeActivityjest częścią platformy Androida i podlega jej cyklowi wydawania wersji (zwykle rocznemu).GameActivityjest częścią biblioteki Jetpack, która ma znacznie częstszy cykl wydawniczy (zwykle co 2 tygodnie). Nowe funkcje i poprawki błędów mogą być wprowadzane znacznie szybciej.
Lokalizacje wydań
Biblioteka GameActivity jest dostępna w tych kanałach:
- jako część biblioteki Android Jetpack (zalecane);
- Jako kod źródłowy AOSP
Kod C/C++ jest udostępniany jako kod źródłowy we wszystkich kanałach wersji w formacie Prefab. GameActivity w wersji 1.2.2 dodaje do dystrybucji bibliotekę statyczną. Od tej wersji zalecamy używanie biblioteki statycznej zamiast kodu źródłowego.
Zawartość biblioteki Jetpack
W bibliotece Jetpack GameActivity jest udostępniana z AAR. Ten raport zawiera te główne komponenty:
- Plik JAR z kodem w języku Java
- Biblioteka statyczna C/C++
game-activity_staticjest dołączona do GameActivity w wersji 1.2.2 lub nowszej. - Kod źródłowy C/C++ (w folderze
/prefab)
Instrukcje integracji, do których linki znajdują się na tej stronie, zakładają, że możesz używać Prefab w swoim systemie kompilacji. Jeśli nie, możesz skopiować kod źródłowy spakowany w folderze prefab/modules/game-activity/include do swojego systemu kompilacji i wykonać niezbędne czynności integracyjne. Podobna struktura plików istnieje w przypadku wersji w androidx biblioteki Android Jetpack. Domyślnie Gradle rozpakowuje pliki AAR w swoim katalogu pamięci podręcznej (~/.gradle/caches/...). Kod źródłowy C/C++ znajdziesz, wyszukując prefab/modules/game-activity/include i wybierając lokalizację w odpowiedniej wersji do publikacji.
Instrukcje dotyczące integracji za pomocą biblioteki Jetpack znajdziesz w artykule Pierwsze kroki z GameActivity.
Zawartość kodu źródłowego AOSP
AOSP zawsze zawiera najnowszy kod źródłowy. Postępuj zgodnie z instrukcjami kompilacji, aby utworzyć własne wersje lub bezpośrednio zintegrować źródło ze środowiskiem kompilacji. Kod źródłowy C/C++ jest zapisywany w strukturze plików podobnej do biblioteki Jetpack.
Przewodniki po integracji
Aby zintegrować GameActivity z aplikacjami, postępuj zgodnie z tymi instrukcjami:
Dodatkowe materiały
Więcej informacji o GameActivity znajdziesz w tych artykułach:
- Informacje o wersji GameActivity i AGDK
- Używanie GameTextInput w GameActivity
- Przewodnik po migracji NativeActivity
- Dokumentacja na temat GameActivity
- Implementacja GameActivity
Prześlij opinię
Aby zgłosić błąd lub poprosić o dodanie nowych funkcji w GameActivity, użyj narzędzia Issue Tracker GameActivity.