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ę:

alt_text

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_glue oraz wykonuje kod gry w wątku native_app_glue.

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:

  • GameActivity renderuje się w SurfaceView, co znacznie ułatwia grom interakcję z innymi komponentami interfejsu.
  • W przypadku zdarzeń dotknięcia i wprowadzania danych za pomocą klawiszy GameActivity ma zupełnie nową implementację z interfejsem android_input_buffer, oddzielnym od InputQueue, którego używa NativeActivity.
  • GameActivity jest klasą pochodną AppCompatActivity, która umożliwia bezproblemowe korzystanie z innych komponentów Jetpack. ActionBar, Fragment i inne.
  • GameActivity dodaje funkcję wprowadzania tekstu przez integrację biblioteki GameTextInput.
  • Aplikacje pochodzące z GameActivity powinny kompilować wszystkie 3 części kodu C/C++ w jedną bibliotekę. Z drugiej strony funkcje JNI NativeActivity są częścią platformy (zawsze wczytywanej przez system operacyjny). Dlatego tylko native_app_glue i kod C/C++ aplikacji powinny być kompilowane do jednej biblioteki.
  • NativeActivity jest częścią platformy Androida i podlega jej cyklowi wydawania wersji (zwykle rocznemu). GameActivity jest 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:

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_static jest 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:

Prześlij opinię

Aby zgłosić błąd lub poprosić o dodanie nowych funkcji w GameActivity, użyj narzędzia Issue Tracker GameActivity.