GameTextInput بخشی از Android Game Development Kit.
استفاده از کتابخانه GameTextInput جایگزین سادهتری برای نوشتن برنامه Android تمامصفحه است که از صفحهکلید نرمافزاری برای ورودی نوشتار استفاده میکند.
GameTextInput یک میانای برنامهسازی کاربردی ساده برای نمایش یا پنهان کردن صفحهکلید نرمافزاری، تنظیم یا دریافت نوشتار درحال ویرایش، و دریافت اعلان هنگام تغییر نوشتار ارائه میدهد. این برای برنامههای ویرایشگر نوشتار کامل درنظر گرفته نشده است، اما
همچنان از انتخاب و نوشتن پشتیبانی میکند تا برای موارد استفاده معمول در
بازیها مناسب باشد. همچنین، این کتابخانه از ویژگیهای پیشرفته
ویرایشگر روش ورودی (IME) مانند غلطیابی املایی،
تکمیل، و نویسههای چندکلیدی پشتیبانی میکند.
در داخل، GameTextInput نوشتار ورودی را (همراه با
حالتهای مربوطه) در میانگیر داخلی
GameTextInput::currentState_ جمعآوری میکند و هرگونه تغییر در آن را
به برنامه اطلاع میدهد. سپس برنامه پردازش نوشتار را در تابع بازخوانی ثبتشدهاش
انجام میدهد.
دردسترس بودن
از GameTextInput میتوان به روشهای زیر استفاده کرد:
همراه با GameActivity: GameActivity با GameTextInput ادغام میشود. برنامههایی که از GameActivity استفاده میکنند فقط میتوانند از GameTextInput ادغامشده استفاده کنند. دستورالعملهای استفاده بهطور کامل در صفحه GameActivity مستند شده است. برای نمونهای از ادغام GameActivity و GameTextInput، به مخزن games-samples مراجعه کنید. این مدل استفاده در محدوده این راهنما نیست.
بهعنوان کتابخانه مستقل: بقیه راهنما مراحل استفاده را شرح میدهد.
توجه داشته باشید که این دو روش بهصورت متقابل انحصاریاند.
نسخههای رسمی GameTextInput در کتابخانه بازیهای Jetpack
در Google Maven دردسترس است.
راهاندازی ساخت
GameTextInput بهعنوان بایگانی Android (AAR) توزیع میشود.
این AAR حاوی کلاسهای Java و کد منبع C است که ویژگیهای بومی GameTextInput را پیادهسازی میکند. باید این فایلهای منبع را بهعنوان بخشی از فرایند ساخت خود بااستفاده از Prefab اضافه کنید که کتابخانههای بومی و کد منبع را درمعرض پروژه CMake یا ساخت NDK شما قرار میدهد.
دستورالعملهای صفحه بازیهای Jetpack Android را دنبال کنید تا وابستگی کتابخانه
GameTextInputرا به فایلbuild.gradleبازیتان اضافه کنید. توجه داشته باشید که اگر برنامههایتان از 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=trueبسته
game-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را درستیسنجی کنید.
ادغام کردن ساخت
از رشته C که قبلاً به JVM متصل شده است، یا رشته اصلی برنامه،
GameTextInput_initرا با اشارهگرJNIEnvفراخوانی کنید.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); ... }یک کلاس جاوا
InputEnabledTextViewبا دسترسی بهInputConnectionایجاد کن.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" />نمونه
InputEnabledTextViewرا در فعالیت Java خود بازیابی کنید. وقتی از View Binding استفاده میکنید، این کار نسبتاً ساده است: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ارسال کنید تا از رویدادها بهعنوان ساختار حالت CGameTextInputStateمطلع شوید.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 تبدیل کنید. دسترسی به عملکرد برای نمایش
و پنهان کردن IME ازطریق توابع GameTextInput_showIme
و GameTextInput_hideIme.
مرجعها
توسعهدهندگان ممکن است هنگام ایجاد برنامهها با GameTextInput، موارد زیر را مفید بدانند:
- برنامه آزمایشی GameTextInput
- استفاده از GameTextInput با GameActivity
- سند مرجع GameTextInput
- کد منبع GameTextInput
بازخورد
برای هرگونه مشکل و سؤال درباره GameTextInput،
اشکالی در Google IssueTracker ایجاد کنید.