GameActivity-তে TextInput Android Game Development Kit-এর অংশ।
GameActivity, GameTextInput-কে এইভাবে ইন্টিগ্রেট করে:
- র্যাপার প্রদান করা হচ্ছে
- নতুন টেক্সট ইনপুট ইভেন্টের উপলভ্যতার জন্য ফ্ল্যাগ তৈরি করা হচ্ছে
- টেক্সট কন্টেন্টের জন্য GameTextInput-এর স্টেট বাফার সরাসরি ব্যবহার করা
নিচের ডায়াগ্রামে যেমন দেখানো হয়েছে, ব্যবহারকারীর টেক্সট ইনপুটের জন্য অ্যাপ্লিকেশন বিভিন্ন ইন্টার্নাল লজিক্যাল কম্পোনেন্ট ব্যবহার করে:

বিল্ট-ইন GameTextInput লাইব্রেরি ব্যবহার করার তিনটি প্রধান ধাপ আছে:
- UI-তে সফ্ট কীবোর্ড কন্ট্রোল করা
- নতুন টেক্সট কখন উপলভ্য হবে তা জানা
- ব্যবহারকারীর ইনপুট টেক্সট ও তার স্ট্যাটাস ফিরিয়ে আনা হচ্ছে
এই ডকুমেন্টের বাকি অংশে এগুলি সম্পর্কে বিস্তারিত বিবরণ দেওয়া হয়েছে। GameActivity-এর সাথে GameTextInput-এর
উদাহরণ দেখতে,
games-samples রিপোজিটরি দেখুন।
UI-তে সফ্ট কীবোর্ড কন্ট্রোল করা
UI-তে সফ্ট কীবোর্ড কন্ট্রোল করার জন্য GameActivity দুটি ফাংশন প্রদান করে:
GameActivity_showSoftInput()সফ্ট কীবোর্ড দেখায়।GameActivity_hideSoftInput()সফ্ট কীবোর্ড লুকায়।
এগুলির সংজ্ঞা জানতে API রেফারেন্স ডকুমেন্ট দেখুন। কীবোর্ড দেখানোর পরে, অ্যাপ্লিকেশনের UI নিম্নলিখিতটির মতো দেখতে হতে পারে:

টেক্সট উপলভ্য আছে কিনা তা চেক করুন
সফ্ট কীবোর্ড ইভেন্ট জাভা সাইডের 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 ব্যবহারকারীর ডকুমেন্টেশন
- agdkTunnel স্যাম্পেল
- GameActivity-এর জন্য Jetpack রেফারেন্স ডকুমেন্টেশন
- GameTextInput-এর জন্য Jetpack রেফারেন্স ডকুমেন্টেশন
- AGDK সোর্স কোড
মতামত
GameActivity এবং GameTextInput দুটিই Jetpack গেম লাইব্রেরির অংশ। কোনও সমস্যা বা প্রশ্ন থাকলে, Google IssueTracker-এ একটি বাগ তৈরি করুন।