GameActivity-তে TextInput   Android Game Development Kit-এর অংশ।

GameActivity, GameTextInput-কে এইভাবে ইন্টিগ্রেট করে:

  • র‍্যাপার প্রদান করা হচ্ছে
  • নতুন টেক্সট ইনপুট ইভেন্টের উপলভ্যতার জন্য ফ্ল্যাগ তৈরি করা হচ্ছে
  • টেক্সট কন্টেন্টের জন্য GameTextInput-এর স্টেট বাফার সরাসরি ব্যবহার করা

নিচের ডায়াগ্রামে যেমন দেখানো হয়েছে, ব্যবহারকারীর টেক্সট ইনপুটের জন্য অ্যাপ্লিকেশন বিভিন্ন ইন্টার্নাল লজিক্যাল কম্পোনেন্ট ব্যবহার করে:

alt_text

বিল্ট-ইন GameTextInput লাইব্রেরি ব্যবহার করার তিনটি প্রধান ধাপ আছে:

  • UI-তে সফ্ট কীবোর্ড কন্ট্রোল করা
  • নতুন টেক্সট কখন উপলভ্য হবে তা জানা
  • ব্যবহারকারীর ইনপুট টেক্সট ও তার স্ট্যাটাস ফিরিয়ে আনা হচ্ছে

এই ডকুমেন্টের বাকি অংশে এগুলি সম্পর্কে বিস্তারিত বিবরণ দেওয়া হয়েছে। GameActivity-এর সাথে GameTextInput-এর উদাহরণ দেখতে, games-samples রিপোজিটরি দেখুন।

UI-তে সফ্ট কীবোর্ড কন্ট্রোল করা

UI-তে সফ্ট কীবোর্ড কন্ট্রোল করার জন্য GameActivity দুটি ফাংশন প্রদান করে:

এগুলির সংজ্ঞা জানতে API রেফারেন্স ডকুমেন্ট দেখুন। কীবোর্ড দেখানোর পরে, অ্যাপ্লিকেশনের UI নিম্নলিখিতটির মতো দেখতে হতে পারে:

alt_text

টেক্সট উপলভ্য আছে কিনা তা চেক করুন

সফ্ট কীবোর্ড ইভেন্ট জাভা সাইডের GameTextInput থেকে JNI-এর মাধ্যমে 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-এর র‍্যাপার API (সাজেস্ট করা হয়েছে)
  • 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.
    );
}

অ্যাপ্লিকেশন ঐচ্ছিকভাবে GameTextInputState কন্টেন্ট GameActivity_setTextInputState() দিয়ে শুরু করতে পারে।

GameTextInput API-এর মাধ্যমে TextInput-এর স্ট্যাটাস পান

এছাড়াও, অ্যাপ্লিকেশন সরাসরি GameTextInput API ব্যবহার করে বর্তমান GameTextInputState:

  • GameActivity-এর ইন্টার্নাল GameTextInput ইনস্ট্যান্স পেতে GameActivity_getTextInput() ব্যবহার করুন।
  • GameTextInput ইনস্ট্যান্স হাতে নিয়ে, একই GameTextInputState কন্টেন্ট পেতে GameTextInput_getState() কল করুন।

আবার, মনে রাখবেন যে অ্যাপ্লিকেশন সরাসরি GameTextInput ইনিশিয়ালাইজ করা উচিত নয়; GameActivity ইতিমধ্যেই তার ইনিশিয়ালাইজেশন প্রসেসের সময় এটি করে।

কলব্যাক মেকানিজম GameActivity-এর GameActivity_getTextInputState() ফাংশনের মতোই।

রেফারেন্স

GameActivity অ্যাপ্লিকেশন তৈরি করার সময় ডেভেলপাররা নিম্নলিখিত রিসোর্সগুলি সহায়ক বলে মনে করতে পারেন:

মতামত

GameActivity এবং GameTextInput দুটিই Jetpack গেম লাইব্রেরির অংশ। কোনও সমস্যা বা প্রশ্ন থাকলে, Google IssueTracker-এ একটি বাগ তৈরি করুন।