GameTextInput यह Android Game Development Kit का हिस्सा है.
GameTextInput लाइब्रेरी का इस्तेमाल करना, फ़ुल-स्क्रीन Android ऐप्लिकेशन लिखने का एक आसान विकल्प है. यह ऐप्लिकेशन, टेक्स्ट इनपुट के लिए सॉफ़्ट कीबोर्ड का इस्तेमाल करता है.
GameTextInput, सॉफ़्ट कीबोर्ड को दिखाने या छिपाने, मौजूदा टेक्स्ट को सेट करने या पाने, और टेक्स्ट में बदलाव होने पर सूचनाएं पाने के लिए एक आसान एपीआई उपलब्ध कराता है. यह पूरी तरह से टेक्स्ट एडिटर ऐप्लिकेशन के लिए नहीं है. हालांकि, यह गेम में इस्तेमाल होने वाले सामान्य मामलों के लिए, टेक्स्ट चुनने और कंपोज़ करने की सुविधा देता है. साथ ही, यह लाइब्रेरी इनपुट मेथड एडिटर (आईएमई) की बेहतर सुविधाओं के साथ काम करती है. जैसे, स्पेलिंग की जांच करना, पूरा करना, और मल्टी-की वर्ण.
GameTextInput, इनपुट टेक्स्ट को (काम की स्थितियों के साथ) इंटरनल बफ़र GameTextInput::currentState_ में इकट्ठा करता है. साथ ही, इसमें होने वाले किसी भी बदलाव के बारे में ऐप्लिकेशन को सूचना देता है. इसके बाद, ऐप्लिकेशन अपने रजिस्टर किए गए कॉलबैक फ़ंक्शन में टेक्स्ट को प्रोसेस करता है.
उपलब्धता
GameTextInput का इस्तेमाल इन तरीकों से किया जा सकता है:
GameActivity के साथ: GameActivity, GameTextInput को इंटिग्रेट करता है. GameActivity का इस्तेमाल करने वाले ऐप्लिकेशन, सिर्फ़ इंटिग्रेट किए गए GameTextInput का इस्तेमाल कर सकते हैं. इस्तेमाल करने के निर्देश, GameActivity पेज पर पूरी तरह से बताए गए हैं. GameActivity और GameTextInput इंटिग्रेशन का सैंपल देखने के लिए, games-samples रिपॉज़िटरी पर जाएं. इस्तेमाल का यह मॉडल, इस गाइड के दायरे में नहीं आता.
अलग से मौजूद लाइब्रेरी के तौर पर: इस गाइड के बाकी हिस्से में, इसके इस्तेमाल के तरीके बताए गए हैं.
ध्यान दें कि ये दोनों तरीके एक-दूसरे से अलग हैं.
GameTextInput के आधिकारिक रिलीज़, Google Maven में Jetpack games library की रिलीज़ में उपलब्ध हैं.
अपना बिल्ड सेट अप करना
GameTextInput को Android ARchive (AAR) के तौर पर डिस्ट्रिब्यूट किया जाता है.
इस एएआर में Java क्लास और C सोर्स कोड शामिल है. यह GameTextInput की नेटिव सुविधाओं को लागू करता है. आपको इन सोर्स फ़ाइलों को अपने बिल्ड प्रोसेस के हिस्से के तौर पर शामिल करना होगा. इसके लिए, Prefab का इस्तेमाल करें. इससे आपके CMake प्रोजेक्ट या NDK बिल्ड में नेटिव लाइब्रेरी और सोर्स कोड दिखते हैं.
अपने गेम की
build.gradleफ़ाइल मेंGameTextInputलाइब्रेरी डिपेंडेंसी जोड़ने के लिए, Jetpack Android Games पेज पर दिए गए निर्देशों का पालन करें. ध्यान दें कि अगर आपके ऐप्लिकेशन GameActivity का इस्तेमाल कर रहे हैं, तो वे अलग से मौजूदGameTextInputलाइब्रेरी का इस्तेमाल नहीं कर सकते.पक्का करें कि
gradle.propertiesमें ये लाइनें शामिल हों:# Tell Android Studio we are using AndroidX. android.useAndroidX=true # Use Prefab 1.1.2 or higher, which contains a fix for "header only" libs. android.prefabVersion=1.1.2 # Required only if you're using Android Studio 4.0 (4.1 is recommended). # android.enablePrefab=truegame-text-inputपैकेज को इंपोर्ट करें और उसे अपने प्रोजेक्ट कीCMakeLists.txtफ़ाइल में टारगेट के तौर पर जोड़ें:find_package(game-text-input REQUIRED CONFIG) ... target_link_libraries(... game-text-input::game-text-input)GameTextInputको लागू करने के लिए, अपने गेम की किसी एक.cppफ़ाइल में यह लाइन जोड़ें:#include <game-text-input/gametextinput.cpp>GameTextInputC API का इस्तेमाल करने वाली सोर्स फ़ाइलों में, हेडर फ़ाइल शामिल करें:#include <game-text-input/gametextinput.h>ऐप्लिकेशन को कंपाइल करें और चलाएं. अगर आपको CMake से जुड़ी गड़बड़ियां मिलती हैं, तो पुष्टि करें कि एएआर और
build.gradleफ़ाइलें सही तरीके से सेट अप की गई हैं. अगर#includeफ़ाइल नहीं मिलती है, तो अपनीCMakeLists.txtकॉन्फ़िगरेशन फ़ाइल की पुष्टि करें.
अपने बिल्ड को इंटिग्रेट करना
जेवीएम से पहले से अटैच किए गए C थ्रेड या ऐप्लिकेशन के मुख्य थ्रेड से,
JNIEnvपॉइंटर के साथGameTextInput_initको कॉल करें.static GameTextInput* gameTextInput = nullptr; extern "C" JNIEXPORT void JNICALL Java_com_gametextinput_testbed_MainActivity_onCreated(JNIEnv* env, jobject this) { { if(!gameTextInput) gameTextInput = GameTextInput_init(env); ... }InputConnectionके ऐक्सेस के साथ,InputEnabledTextViewJava क्लास बनाएं.public class InputEnabledTextView extends View implements Listener { public InputConnection mInputConnection; public InputEnabledTextView(Context context, AttributeSet attrs) { super(context, attrs); } public InputEnabledTextView(Context context) { super(context); } public void createInputConnection(int inputType) { EditorInfo editorInfo = new EditorInfo(); editorInfo.inputType = inputType; editorInfo.actionId = IME_ACTION_NONE; editorInfo.imeOptions = IME_FLAG_NO_FULLSCREEN; mInputConnection = new InputConnection(this.getContext(), this, new Settings(editorInfo, true) ).setListener(this); } @Override public InputConnection onCreateInputConnection(EditorInfo outAttrs) { if (outAttrs != null) { GameTextInput.copyEditorInfo(mInputConnection.getEditorInfo(), outAttrs); } return mInputConnection; } // Called when the IME input changes. @Override public void stateChanged(State newState, boolean dismissed) { onTextInputEventNative(newState); } @Override public void onImeInsetsChanged(Insets insets) { // handle Inset changes here } private native void onTextInputEventNative(State softKeyboardEvent); }बनाए गए
InputEnabledTextViewको यूज़र इंटरफ़ेस (यूआई) लेआउट में जोड़ें. उदाहरण के लिए,activity_main.xmlमें मौजूद यह कोड, इसे स्क्रीन पर सबसे नीचे दिखा सकता है:<com.android.example.gametextinputjava.InputEnabledTextView android:id="@+id/input_enabled_text_view" android:layout_width="wrap_content" android:layout_height="wrap_content" app:layout_constraintBottom_toBottomOf="parent" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" />अपनी Java गतिविधि में
InputEnabledTextViewइंस्टेंस को वापस पाएं. व्यू बाइंडिंग का इस्तेमाल करने पर, यह काफ़ी आसान हो जाता है:public class MainActivity extends AppCompatActivity { ... private ActivityMainBinding binding; private InputEnabledTextView inputEnabledTextView; private native void setInputConnectionNative(InputConnection c); @Override protected void onCreate(Bundle savedInstanceState) { ... binding = ActivityMainBinding.inflate(getLayoutInflater()); inputEnabledTextView = binding.inputEnabledTextView; inputEnabledTextView.createInputConnection(InputType.TYPE_CLASS_TEXT); setInputConnectionNative(inputEnabledTextView.mInputConnection); }अपनी C लाइब्रेरी में,
inputConnectionकोGameTextInput_setInputConnectionमें पास करें.GameTextInput_setEventCallbackमें कॉलबैक पास करें, ताकि C स्टेट स्ट्रक्चरGameTextInputStateके तौर पर इवेंट की सूचना दी जा सके.extern "C"JNIEXPORT void JNICALL Java_com_gametextinput_testbed_MainActivity_setInputConnectionNative( JNIEnv *env, jobject this, jobject inputConnection) { GameTextInput_setInputConnection(gameTextInput, inputConnection); GameTextInput_setEventCallback(gameTextInput,[](void *ctx, const GameTexgtInputState *state) { if (!env || !state) return; // process the newly arrived text input from user. __android_log_print(ANDROID_LOG_INFO, "TheGreateGameTextInput", state->text_UTF8); }, env); }अपनी C लाइब्रेरी में,
GameTextInput_processEventको कॉल करें. यह इंटरनल तौर पर, पिछले चरण में रजिस्टर किए गए आपके कॉलबैक को कॉल करता है. इससे आपके ऐप्लिकेशन को, स्थिति बदलने पर इवेंट मैनेज करने में मदद मिलती है.extern "C" JNIEXPORT void JNICALL Java_com_gametextinput_testbed_InputEnabledTextView_onTextInputEventNative( JNIEnv* env, jobject this, jobject soft_keyboard_event) { GameTextInput_processEvent(gameTextInput, soft_keyboard_event); }
उपयोगिता फ़ंक्शन
GameTextInput लाइब्रेरी में ऐसे यूटिलिटी फ़ंक्शन शामिल हैं जिनकी मदद से, Java स्टेट ऑब्जेक्ट और C स्टेट स्ट्रक्चर के बीच कन्वर्ज़न किया जा सकता है. GameTextInput_showIme और GameTextInput_hideIme फ़ंक्शन की मदद से, आईएमई को दिखाने और छिपाने की सुविधा को ऐक्सेस करें.
संदर्भ
GameTextInput की मदद से ऐप्लिकेशन बनाते समय, डेवलपर को इन चीज़ों से मदद मिल सकती है:
- GameTextInput टेस्ट ऐप्लिकेशन
- GameActivity के साथ GameTextInput का इस्तेमाल करना
- GameTextInput का रेफ़रंस दस्तावेज़
- GameTextInput का सोर्स कोड
सुझाव/राय दें या शिकायत करें
GameTextInput से जुड़ी किसी भी समस्या और सवाल के लिए, Google IssueTracker पर गड़बड़ी की शिकायत करें.