TextInput w GameActivity   Jest częścią Android Game Development Kit.

GameActivity integruje GameTextInput przez:

  • zapewnienie modułu owijającego,
  • tworzenie flagi dostępności zdarzenia nowego wprowadzania tekstu,
  • bezpośrednio przy użyciu bufora stanu GameTextInput dla treści tekstowych,

Jak pokazano na poniższym diagramie, aplikacje używają różnych wewnętrznych komponentów logicznych do wprowadzania tekstu przez użytkownika:

alt_text

Korzystanie z wbudowanej biblioteki GameTextInput obejmuje 3 główne kroki:

  • Sterowanie klawiaturą ekranową w interfejsie
  • Powiadomienia o nowym tekście
  • pobieranie tekstu wpisanego przez użytkownika i jego stanów,

W dalszej części tego dokumentu znajdziesz szczegółowe informacje na ich temat. Przykład działania GameTextInput z GameActivity znajdziesz w repozytorium games-samples.

Sterowanie klawiaturą ekranową w interfejsie

GameActivity udostępnia 2 funkcje do sterowania klawiaturą ekranową w interfejsie:

Definicje znajdziesz w dokumentacji API. Po wyświetleniu klawiatury interfejs aplikacji może wyglądać podobnie do tego:

alt_text

Sprawdzanie dostępności tekstu

Zdarzenia klawiatury ekranowej są przekazywane z GameTextInput po stronie Javy do strony C/C++ przez JNI, a następnie trafiają do kodu otaczającego GameActivity, co ostatecznie odzwierciedla flaga android_app::textInputState zaimplementowana w native_app_glue. Aplikacje powinny okresowo sprawdzać tę flagę, aby wykonać zamierzone przetwarzanie:

  • GameActivity ustawia tylko flagę android_app::textInputState.
  • Aplikacje sprawdzają flagę i obsługują nowe zdarzenia GameTextInput, takie jak nowy tekst dodany do bufora wejściowego.
  • Aplikacje czyszczą android_app::textInputState.

Pamiętaj, że android_app::textInputState nie rozróżnia pojedynczych i wielokrotnych zdarzeń wprowadzania tekstu.

Na przykład ten kod sprawdza flagę textInputState po obsłużeniu poleceń cyklu aplikacji, zdarzeń dotknięcia i zdarzeń klawiszy:

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.
   }
}

pobieranie tekstu wpisanego przez użytkownika,

Teksty wejściowe i inne stany są gromadzone w buforze wewnętrznym GameTextInput, GameTextInput::currentState_. Aplikacje mogą pobierać zawartość na jeden z tych sposobów:

  • Interfejs API opakowania GameActivity (zalecany)
  • GameTextInput API

Pobieranie stanu TextInput za pomocą interfejsu GameActivity API

Aplikacje uzyskują bieżący tekst wprowadzany za pomocą typowego mechanizmu wywołania zwrotnego:

  • Zaimplementuj funkcję wywołania zwrotnego typu GameTextInputGetStateCallback, aby przetwarzać zdarzenia wprowadzania tekstu.
  • Wywołaj GameActivity_getInputState(), gdy występuje co najmniej jedno nieobsłużone zdarzenie.
  • Po przetworzeniu zdarzeń wyczyść android_app::textInputState.

Kontynuując fragment kodu z poprzedniej sekcji, poniższy kod pobiera odwołanie do bufora wprowadzania tekstu, przetwarza go (nie pokazano) i resetuje flagę zdarzenia:

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;
}

W pętli gry pokazanej w poprzedniej sekcji sprawdź i przetwórz tekst za pomocą poprzedniego modułu obsługi wprowadzania tekstu:

if (state->textInputState) {
    GameActivity_getTextInputState(
        app->activity,
        GameTextInputGetStateCB,  // App's event handler shown above.
        &engine // Context to the GameTextInputGetStateCB function.
    );
}

Aplikacje mogą opcjonalnie inicjować zawartość GameTextInputState za pomocą GameActivity_setTextInputState().

Pobieranie stanu TextInput za pomocą interfejsu GameTextInput API

Aplikacje mogą też bezpośrednio używać interfejsu API GameTextInput, aby pobrać bieżący GameTextInputState:

Pamiętaj, że aplikacje nie powinny inicjować GameTextInput bezpośrednio. GameActivity robi to już podczas procesu inicjowania.

Mechanizm wywołania zwrotnego jest taki sam jak w przypadku funkcji GameActivity_getTextInputState() GameActivity.

Odniesienia

Deweloperom mogą się przydać te materiały dotyczące tworzenia aplikacji GameActivity:

Prześlij opinię

GameActivity i GameTextInput są częścią biblioteki gier Jetpack. Jeśli masz problemy lub pytania, zgłoś błąd w narzędziu Google IssueTracker.