GameActivity Входит в Android Game Development Kit.
GameActivity – это библиотека Jetpack, которая помогает играм для Android обрабатывать команды жизненного цикла приложения, события ввода и ввод текста в коде C/C++ приложения. GameActivity – прямой потомок NativeActivity с похожей архитектурой.

Как показано на схеме выше, GameActivity выполняет следующие функции:
- Взаимодействие с фреймворком Android через компонент на стороне Java.
- Передача команд цикла приложения, событий ввода и текста ввода на нативную сторону.
- Моделирование исходного кода C/C++ в виде трех логических компонентов:
- JNI-функции GameActivity, которые напрямую поддерживают Java-функциональность GameActivity и ставят события в очередь в
native_app_glue. native_app_glue, который в основном выполняется в собственном нативном потоке (отличном от основного потока приложения) и выполняет задачи с помощью своего цикла.- Код игры, который опрашивает и обрабатывает события, поставленные в очередь внутри
native_app_glue, и выполняет код игры в потокеnative_app_glue.
- JNI-функции GameActivity, которые напрямую поддерживают Java-функциональность GameActivity и ставят события в очередь в
С GameActivity вы можете сосредоточиться на разработке игры и не тратить время на работу с кодом JNI.
Если вы уже знакомы с NativeActivity, то основные различия между GameActivity и NativeActivity заключаются в следующем:
GameActivityпреобразуется вSurfaceView, что значительно упрощает взаимодействие игр с другими компонентами интерфейса.- Для событий касания и нажатия клавиш в
GameActivityиспользуется совершенно новая реализация с интерфейсомandroid_input_buffer, отдельным отInputQueue, который используется вNativeActivity. GameActivity– это производный классAppCompatActivity, который позволяет без проблем использовать другие компоненты Jetpack.ActionBar,Fragmentи другие.GameActivityдобавляет функцию ввода текста за счет интеграции библиотеки GameTextInput.- Приложения, созданные на основе
GameActivity, должны компилировать все три части кода C/C++ в одну библиотеку. С другой стороны, функции JNI вNativeActivityявляются частью фреймворка (всегда загружаются ОС). Поэтому в одну библиотеку должны быть встроены толькоnative_app_glueи код приложения на C/C++. NativeActivity– это часть фреймворка Android, и ее обновления выходят вместе с ним (обычно раз в год).GameActivityвходит в библиотеку Jetpack, которая обновляется гораздо чаще (обычно раз в две недели). Это позволяет быстрее добавлять новые функции и исправления ошибок.
Освобождение переговорных комнат
Библиотека GameActivity доступна в следующих каналах:
- В составе библиотеки Android Jetpack (рекомендуется).
- В виде исходного кода AOSP
Код C/C++ предоставляется в виде исходного кода во всех каналах обновления в формате Prefab. В GameActivity версии 1.2.2 добавлена статическая библиотека. Начиная с этой версии мы рекомендуем использовать статическую библиотеку вместо исходного кода.
Содержимое библиотеки Jetpack
В библиотеке Jetpack GameActivity выпускается с AAR. В этом отчете содержатся следующие основные компоненты:
- JAR-файл для кода Java;
- Статическая библиотека C/C++
game-activity_staticвключена в GameActivity версии 1.2.2 и более поздних. - исходный код C/C++ (в папке
/prefab);
Инструкции по интеграции, ссылки на которые приведены на этой странице, предполагают, что вы можете использовать Prefab в своей системе сборки. В противном случае вы можете скопировать исходный код, упакованный в папку prefab/modules/game-activity/include, в свою систему сборки и выполнить необходимые шаги интеграции. Аналогичная структура файлов существует для выпусков в androidx для библиотеки Android Jetpack. По умолчанию gradle распаковывает AAR в свой каталог кеша (~/.gradle/caches/...). Чтобы найти исходный код C/C++, введите в поиске prefab/modules/game-activity/include и выберите нужную версию.
Инструкции по интеграции с помощью библиотеки Jetpack можно найти в статье Начало работы с GameActivity.
Контент исходного кода AOSP
В AOSP всегда содержится самый актуальный исходный код. Чтобы создать собственные выпуски или интегрировать исходный код непосредственно в среду сборки, следуйте инструкциям по сборке. Исходный код C/C++ сохраняется в структуре файлов, аналогичной библиотеке Jetpack.
Руководства по интеграции
Чтобы интегрировать GameActivity в свои приложения, следуйте этим руководствам:
Дополнительные ресурсы
Дополнительную информацию о GameActivity можно найти в следующих статьях:
- Примечания к выпуску GameActivity и AGDK
- Как использовать GameTextInput в GameActivity
- руководстве по переходу с NativeActivity.
- Справочная документация по GameActivity
- Реализация GameActivity.
Отзыв
Чтобы сообщить об ошибке или запросить новую функцию для GameActivity, используйте систему отслеживания ошибок GameActivity.