TextInput в GameActivity Входит в Android Game Development Kit.
GameActivity интегрирует GameTextInput следующим образом:
- предоставление контейнера
- Создание пометки для доступности нового события ввода текста
- напрямую использовать буфер состояния GameTextInput для текстового контента;
Как показано на схеме ниже, для ввода текста в приложениях используются разные внутренние логические компоненты:

Чтобы использовать встроенную библиотеку GameTextInput, выполните следующие действия:
- Управление экранной клавиатурой в интерфейсе
- Как узнать, что появился новый текст
- Получение текста, введенного пользователем, и его состояний
Ниже приведены подробные сведения о них. Пример использования GameTextInput с GameActivity можно найти в хранилище примеров игр.
Управление экранной клавиатурой в интерфейсе
В GameActivity есть две функции для управления экранной клавиатурой в интерфейсе:
GameActivity_showSoftInput()– показать экранную клавиатуру.GameActivity_hideSoftInput()скрывает экранную клавиатуру.
Определения этих терминов можно найти в справочной документации по API. После того как клавиатура появится, интерфейс приложения может выглядеть примерно так:

Проверьте, доступен ли текст
События экранной клавиатуры передаются из GameTextInput на стороне Java на сторону C/C++ через JNI, затем переходят в оболочку GameActivity и в итоге отражаются в флаге android_app::textInputState, реализованном в native_app_glue. Приложения должны периодически проверять этот флаг, чтобы выполнять необходимую обработку:
- GameActivity устанавливает только флаг
android_app::textInputState. - Приложения опрашивают флаг и обрабатывают новые события
GameTextInput, например добавление нового текста в буфер ввода. - Приложения очищают
android_app::textInputState.
Обратите внимание, что android_app::textInputState не различает одиночные и множественные события ввода текста.
Например, следующий код опрашивает флаг textInputState после обработки команд цикла приложения, событий касания и ключевых событий:
while (true) {
// Read all pending events.
int events;
struct android_poll_source* source;
while ((ALooper_pollOnce(engine.animating ? 0 : -1, nullptr, &events,
(void**)&source)) >= 0) {
// Process this event, etc.
...
// Check if we are exiting.
if (app->destroyRequested != 0) {
engine_term_display(&engine);
return;
}
}
engine_handle_input(app);
// Process text input events if there is any outstanding.
if (app->textInputState) {
// process TextInput events.
...
//reset the textInputState flag
app->textInputState = 0;
}
if (engine.animating) {
// draw frames.
}
}
Получить текст, введенный пользователем
Введенные тексты и другие состояния накапливаются во внутреннем буфере GameTextInput, GameTextInput::currentState_. Приложения могут получать контент одним из следующих способов:
- API-оболочка GameActivity (рекомендуется)
- GameTextInput API
Как получить состояние TextInput с помощью GameActivity API
Приложения получают текущий текстовый ввод с помощью стандартного механизма обратного вызова:
- Реализуйте функцию обратного вызова типа
GameTextInputGetStateCallbackдля обработки событий ввода текста. - Вызовите
GameActivity_getInputState(), если есть одно или несколько невыполненных событий. - Очистите
android_app::textInputStateпосле обработки событий.
Продолжая пример из предыдущего раздела, следующий код получает ссылку на буфер ввода текста, обрабатывает его (не показано) и сбрасывает флаг события:
extern "C" void GameTextInputGetStateCB(void *ctx, const struct GameTextInputState *state) {
auto* engine = (struct engine*)ctx;
if (!engine || !state) return;
// Process the text event(s).
LOGI("UserInputText: %s", state->text_UTF8);
// Clear the text input flag.
engine->app->textInputState = 0;
}
В игровом цикле, показанном в предыдущем разделе, проверьте и обработайте текст с помощью предыдущего обработчика ввода текста:
if (state->textInputState) {
GameActivity_getTextInputState(
app->activity,
GameTextInputGetStateCB, // App's event handler shown above.
&engine // Context to the GameTextInputGetStateCB function.
);
}
Приложения могут инициализировать контент GameTextInputState с помощью GameActivity_setTextInputState().
Как получить состояние TextInput с помощью GameTextInput API
Приложения также могут напрямую использовать API GameTextInput, чтобы получить текущее значение GameTextInputState:
- Чтобы получить внутренний экземпляр
GameTextInputGameActivity, используйтеGameActivity_getTextInput(). - Получив экземпляр
GameTextInput, вызовитеGameTextInput_getState(), чтобы получить тот же контентGameTextInputState.
Напоминаем, что приложения не должны инициализировать GameTextInput напрямую. Это уже делает GameActivity в процессе инициализации.
Механизм обратного вызова такой же, как и в функции GameActivity_getTextInputState() GameActivity.
Ссылки
При создании приложений GameActivity разработчикам могут пригодиться следующие ресурсы:
- Начало работы с GameActivity
- Документация по GameTextInput
- Пример agdkTunnel
- Справочная документация по GameActivity в Jetpack
- Справочная документация по GameTextInput в Jetpack
- Исходный код AGDK
Отзыв
GameActivity и GameTextInput входят в библиотеку игр Jetpack. Если у вас возникнут проблемы или вопросы, создайте заявку в Google IssueTracker.