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 বিল্ড-এ নেটিভ লাইব্রেরি এবং সোর্স কোড দেখায়।

  1. আপনার গেমের build.gradle ফাইলে GameTextInput লাইব্রেরি ডিপেন্ডেন্সি যোগ করতে Jetpack Android Games পৃষ্ঠায় দেওয়া নির্দেশাবলী অনুসরণ করুন। মনে রাখবেন যে আপনার অ্যাপ্লিকেশন GameActivity ব্যবহার করলে, সেগুলি স্বতন্ত্র GameTextInput লাইব্রেরি ব্যবহার করতে পারবে না।

  2. 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=true
    
  3. game-text-input প্যাকেজ ইমপোর্ট করুন এবং আপনার প্রোজেক্টের CMakeLists.txt ফাইলে আপনার টার্গেটে এটি যোগ করুন:

    find_package(game-text-input REQUIRED CONFIG)
    ...
    target_link_libraries(... game-text-input::game-text-input)
    
  4. আপনার গেমের .cpp ফাইলগুলির মধ্যে একটিতে, GameTextInput ইমপ্লিমেন্টেশন অন্তর্ভুক্ত করতে নিম্নলিখিত লাইনটি যোগ করুন:

    #include <game-text-input/gametextinput.cpp>
    
  5. GameTextInput C API ব্যবহার করে এমন সোর্স ফাইলে, হেডার ফাইল অন্তর্ভুক্ত করুন:

    #include <game-text-input/gametextinput.h>
    
  6. অ্যাপ কম্পাইল ও রান করুন। CMake সংক্রান্ত সমস্যা হলে, AAR এবং build.gradle ফাইল সঠিকভাবে সেট-আপ করা হয়েছে কিনা তা যাচাই করুন। #include ফাইলটি খুঁজে না পাওয়া গেলে, আপনার CMakeLists.txt কনফিগারেশন ফাইলটি যাচাই করুন।

আপনার বিল্ড ইন্টিগ্রেট করুন

  1. 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);
        ...
    }
    
  2. InputConnection-এ অ্যাক্সেস সহ একটি InputEnabledTextView Java ক্লাস তৈরি করুন।

    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);
    }
    
  3. তৈরি করা InputEnabledTextView UI লেআউটে যোগ করুন। যেমন, 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" />
    
  4. আপনার 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);
      }
    
  5. আপনার 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);
    }
    
  6. আপনার 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-এর জন্য কোনও সমস্যা এবং প্রশ্নের জন্য, Google IssueTracker-এ একটি বাগ তৈরি করুন।