TextInput в GameActivity   Входит в Android Game Development Kit.

GameActivity интегрирует GameTextInput следующим образом:

  • предоставление контейнера
  • Создание пометки для доступности нового события ввода текста
  • напрямую использовать буфер состояния GameTextInput для текстового контента;

Как показано на схеме ниже, для ввода текста в приложениях используются разные внутренние логические компоненты:

alt_text

Чтобы использовать встроенную библиотеку GameTextInput, выполните следующие действия:

  • Управление экранной клавиатурой в интерфейсе
  • Как узнать, что появился новый текст
  • Получение текста, введенного пользователем, и его состояний

Ниже приведены подробные сведения о них. Пример использования GameTextInput с GameActivity можно найти в хранилище примеров игр.

Управление экранной клавиатурой в интерфейсе

В GameActivity есть две функции для управления экранной клавиатурой в интерфейсе:

Определения этих терминов можно найти в справочной документации по API. После того как клавиатура появится, интерфейс приложения может выглядеть примерно так:

alt_text

Проверьте, доступен ли текст

События экранной клавиатуры передаются из 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:

  • Чтобы получить внутренний экземпляр GameTextInput GameActivity, используйте GameActivity_getTextInput().
  • Получив экземпляр GameTextInput, вызовите GameTextInput_getState(), чтобы получить тот же контент GameTextInputState.

Напоминаем, что приложения не должны инициализировать GameTextInput напрямую. Это уже делает GameActivity в процессе инициализации.

Механизм обратного вызова такой же, как и в функции GameActivity_getTextInputState() GameActivity.

Ссылки

При создании приложений GameActivity разработчикам могут пригодиться следующие ресурсы:

Отзыв

GameActivity и GameTextInput входят в библиотеку игр Jetpack. Если у вас возникнут проблемы или вопросы, создайте заявку в Google IssueTracker.