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:

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:
GameActivity_showSoftInput()wyświetla klawiaturę ekranową.GameActivity_hideSoftInput()ukrywa klawiaturę ekranową.
Definicje znajdziesz w dokumentacji API. Po wyświetleniu klawiatury interfejs aplikacji może wyglądać podobnie do tego:

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:
- Użyj
GameActivity_getTextInput(), aby uzyskać wewnętrzną instancjęGameTextInputGameActivity. - Mając instancję
GameTextInput, wywołajGameTextInput_getState(), aby uzyskać tę samą treść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:
- Pierwsze kroki z GameActivity
- Dokumentacja użytkownika GameTextInput
- Przykładowa gra agdkTunnel
- Dokumentacja Jetpacka dotycząca GameActivity
- Dokumentacja Jetpacka dotycząca GameTextInput
- Kod źródłowy AGDK
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.