GameTextInput Android Game Development Kit-এর অংশ।
GameTextInput লাইব্রেরি ব্যবহার করা হল
ফুল-স্ক্রিন Android অ্যাপ লেখার একটি সহজ বিকল্প যা টেক্সট ইনপুটের জন্য সফ্ট কীবোর্ড
ব্যবহার করে।
GameTextInput সফ্ট কীবোর্ড দেখানো বা লুকানো, বর্তমানে এডিট করা টেক্সট সেট করা বা পাওয়া এবং টেক্সট পরিবর্তন হলে বিজ্ঞপ্তি পাওয়ার জন্য একটি সহজ API প্রদান করে। এটি সম্পূর্ণ টেক্সট এডিটর অ্যাপের জন্য নয়, তবে
এখনও গেমের সাধারণ ব্যবহারের ক্ষেত্রে
নির্বাচন এবং কম্পোজ করার জন্য অঞ্চল সংক্রান্ত সহায়তা প্রদান করে। এছাড়াও, এই লাইব্রেরি উন্নত
ইনপুট পদ্ধতি এডিটর (IME) ফিচার যেমন বানান-পরীক্ষা,
সম্পূর্ণ করা এবং মাল্টি-কী অক্ষর সাপোর্ট করে।
ইন্টার্নালি, GameTextInput ইনপুট টেক্সট (প্রাসঙ্গিক স্টেট সহ) ইন্টার্নাল বাফারে
GameTextInput::currentState_ জমা করে এবং এতে কোনও পরিবর্তন হলে
অ্যাপকে বিজ্ঞপ্তি পাঠায়। অ্যাপটি তখন তার রেজিস্টার করা কলব্যাক ফাংশনে টেক্সট প্রসেস করে।
উপলভ্যতা
GameTextInput নিম্নলিখিত উপায়ে ব্যবহার করা যেতে পারে:
GameActivity-এর সাথে: GameActivity-তে GameTextInput ইন্টিগ্রেট করা থাকে। GameActivity ব্যবহার করে এমন অ্যাপ্লিকেশন শুধুমাত্র ইন্টিগ্রেটেড GameTextInput ব্যবহার করতে পারে। ব্যবহার সংক্রান্ত নির্দেশাবলী সম্পূর্ণভাবে GameActivity পৃষ্ঠায় ডকুমেন্ট করা আছে। GameActivity এবং GameTextInput ইন্টিগ্রেশনের স্যাম্পেল দেখতে, games-samples রিপোজিটরি দেখুন। এই ব্যবহার মডেলটি এই গাইডের আওতার মধ্যে পড়ে না।
স্ট্যান্ডঅ্যালোন লাইব্রেরি হিসেবে: নির্দেশিকার বাকি অংশে ব্যবহারের ধাপগুলি বর্ণনা করা হয়েছে।
মনে রাখবেন যে এই দুটি পদ্ধতি পারস্পরিকভাবে স্বতন্ত্র।
আনুষ্ঠানিক GameTextInput রিলিজ Jetpack গেম লাইব্রেরিতে উপলভ্য
Google Maven-এ রিলিজ।
আপনার বিল্ড সেট-আপ করুন
GameTextInput, Android Archive (AAR) হিসেবে ডিস্ট্রিবিউট করা হয়।
এই 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)আপনার গেমের
.cppফাইলগুলির মধ্যে একটিতে,GameTextInputইমপ্লিমেন্টেশন অন্তর্ভুক্ত করতে নিম্নলিখিত লাইনটি যোগ করুন:#include <game-text-input/gametextinput.cpp>GameTextInputC API ব্যবহার করে এমন সোর্স ফাইলে, হেডার ফাইল অন্তর্ভুক্ত করুন:#include <game-text-input/gametextinput.h>অ্যাপ কম্পাইল ও রান করুন। CMake সংক্রান্ত সমস্যা হলে, AAR এবং
build.gradleফাইল সঠিকভাবে সেট-আপ করা হয়েছে কিনা তা যাচাই করুন।#includeফাইলটি খুঁজে না পাওয়া গেলে, আপনারCMakeLists.txtকনফিগারেশন ফাইলটি যাচাই করুন।
আপনার বিল্ড ইন্টিগ্রেট করুন
JVM-এর সাথে আগে থেকেই অ্যাটাচ করা আপনার 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); }তৈরি করা
InputEnabledTextViewUI লেআউটে যোগ করুন। যেমন,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-এ পাস করুন। C স্টেট স্ট্রাক্টGameTextInputStateহিসেবে ইভেন্টের বিজ্ঞপ্তি পেতেGameTextInput_setEventCallback-এ কলব্যাক পাস করুন।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 ফাংশনের মাধ্যমে IME দেখানো
এবং লুকানোর জন্য অ্যাক্সেস কার্যকারিতা।
রেফারেন্স
GameTextInput-এর সাহায্যে অ্যাপ তৈরি করার সময় ডেভেলপাররা নিম্নলিখিত বিষয়গুলি সহায়ক হিসেবে পেতে পারেন:
- GameTextInput টেস্ট অ্যাপ
- GameActivity-এর সাথে GameTextInput ব্যবহার করা
- GameTextInput রেফারেন্স ডকুমেন্ট
- GameTextInput সোর্স কোড
মতামত
GameTextInput-এর জন্য কোনও সমস্যা এবং প্রশ্নের জন্য,
Google IssueTracker-এ একটি বাগ তৈরি করুন।