GameActivity में TextInput यह Android Game Development Kit का हिस्सा है.
GameActivity, GameTextInput को इंटिग्रेट करता है. इसके लिए, वह:
- रैपर उपलब्ध कराना
- टेक्स्ट इनपुट के नए इवेंट की उपलब्धता के लिए फ़्लैग बनाना
- सीधे तौर पर GameTextInput के स्टेट बफ़र का इस्तेमाल करके, टेक्स्ट कॉन्टेंट के लिए
यहां दिए गए डायग्राम में दिखाया गया है कि ऐप्लिकेशन, उपयोगकर्ता के टेक्स्ट इनपुट के लिए अलग-अलग इंटरनल लॉजिकल कॉम्पोनेंट का इस्तेमाल करते हैं:

पहले से मौजूद GameTextInput लाइब्रेरी का इस्तेमाल करने के लिए, ये तीन मुख्य चरण हैं:
- यूज़र इंटरफ़ेस (यूआई) पर सॉफ़्ट कीबोर्ड को कंट्रोल करना
- नया टेक्स्ट उपलब्ध होने पर सूचना पाना
- उपयोगकर्ता के इनपुट टेक्स्ट और उसकी स्थितियों को वापस पाना
इस दस्तावेज़ के अगले हिस्से में, इनके बारे में ज़्यादा जानकारी दी गई है. GameActivity के साथ GameTextInput के इस्तेमाल का उदाहरण देखने के लिए, games-samples रिपॉज़िटरी पर जाएं.
यूज़र इंटरफ़ेस (यूआई) पर सॉफ़्ट कीबोर्ड को कंट्रोल करती है
GameActivity, यूज़र इंटरफ़ेस (यूआई) पर सॉफ़्ट कीबोर्ड को कंट्रोल करने के लिए दो फ़ंक्शन उपलब्ध कराता है:
GameActivity_showSoftInput()सॉफ़्ट कीबोर्ड दिखाता है.GameActivity_hideSoftInput()सॉफ़्ट कीबोर्ड को छिपाता है.
इनकी परिभाषाएं जानने के लिए, एपीआई के संदर्भ दस्तावेज़ देखें. कीबोर्ड दिखने के बाद, ऐप्लिकेशन का यूज़र इंटरफ़ेस (यूआई) कुछ ऐसा दिख सकता है:

यह देखना कि टेक्स्ट उपलब्ध है या नहीं
सॉफ़्ट कीबोर्ड इवेंट, JNI के ज़रिए Java साइड पर GameTextInput से C/C++ साइड पर पास किए जाते हैं. इसके बाद, वे GameActivity के रैपर तक जाते हैं. आखिर में, native_app_glue में लागू किए गए android_app::textInputState फ़्लैग में दिखते हैं. ऐप्लिकेशन को समय-समय पर इस फ़्लैग को पोल करना चाहिए, ताकि तय की गई प्रोसेसिंग की जा सके:
- 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_ में इकट्ठा किए जाते हैं. ऐप्लिकेशन, अपने कॉन्टेंट को वापस पाने के लिए इनमें से किसी एक तरीके का इस्तेमाल कर सकते हैं:
- GameActivity का रैपर एपीआई (सुझाया गया)
- GameTextInput API
GameActivity API की मदद से TextInput की स्थिति पाना
ऐप्लिकेशन, सामान्य कॉलबैक तरीके से मौजूदा टेक्स्ट इनपुट हासिल करते हैं:
- टेक्स्ट इनपुट इवेंट को प्रोसेस करने के लिए,
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.
);
}
ऐप्लिकेशन, GameActivity_setTextInputState() के साथ GameTextInputState कॉन्टेंट को शुरू कर सकते हैं.
GameTextInput API की मदद से TextInput की स्थिति पाना
ऐप्लिकेशन, मौजूदा GameTextInputState को वापस पाने के लिए, सीधे GameTextInput एपीआई का भी इस्तेमाल कर सकते हैं:
- GameActivity के इंटरनल
GameTextInputइंस्टेंस को पाने के लिए,GameActivity_getTextInput()का इस्तेमाल करें. GameTextInputइंस्टेंस मिलने के बाद,GameTextInputStateकॉन्टेंट पाने के लिएGameTextInput_getState()को कॉल करें.
ध्यान दें कि ऐप्लिकेशन को GameTextInput को सीधे तौर पर शुरू नहीं करना चाहिए. GameActivity, शुरू होने की प्रोसेस के दौरान ऐसा पहले ही कर देता है.
कॉलबैक का तरीका, GameActivity के GameActivity_getTextInputState() फ़ंक्शन में इस्तेमाल किए गए तरीके जैसा ही है.
संदर्भ
GameActivity ऐप्लिकेशन बनाते समय, डेवलपर को इन संसाधनों से मदद मिल सकती है:
- GameActivity का इस्तेमाल शुरू करना
- GameTextInput के उपयोगकर्ता के लिए दस्तावेज़
- agdkTunnel सैंपल
- GameActivity के लिए Jetpack का रेफ़रंस दस्तावेज़
- GameTextInput के लिए Jetpack का रेफ़रंस दस्तावेज़
- AGDK सोर्स कोड
सुझाव/राय दें या शिकायत करें
GameActivity और GameTextInput, दोनों Jetpack गेम लाइब्रेरी का हिस्सा हैं. किसी भी समस्या और सवाल के लिए, Google IssueTracker पर गड़बड़ी की शिकायत करें.