GameTextInput   Android Game Development Kit'in bir parçasıdır.

GameTextInput kitaplığını kullanmak, metin girişi için sanal klavyeyi kullanan tam ekran bir Android uygulaması yazmaya kıyasla daha basit bir alternatiftir.

GameTextInput, sanal klavyeyi göstermek veya gizlemek, düzenlenmekte olan metni ayarlamak ya da almak ve metin değiştirildiğinde bildirim almak için basit bir API sağlar. Bu, tam teşekküllü metin düzenleyici uygulamaları için tasarlanmamıştır ancak oyunlardaki tipik kullanım alanları için seçim ve oluşturma bölgesi desteği sağlar. Ayrıca bu kitaplık, yazım denetimi, tamamlama ve çok tuşlu karakterler gibi gelişmiş giriş yöntemi düzenleyici (IME) özelliklerini destekler.

Dahili olarak GameTextInput, giriş metnini (ilgili durumlarla birlikte) dahili arabelleğe GameTextInput::currentState_ ekler ve uygulamayı değişiklikler konusunda bilgilendirir. Uygulama daha sonra kayıtlı geri çağırma işlevinde metin işleme gerçekleştirir.

Kullanılabilirlik

GameTextInput aşağıdaki şekillerde kullanılabilir:

  • GameActivity ile birlikte: GameActivity, GameTextInput'i entegre eder. GameActivity'yi kullanan uygulamalar yalnızca entegre GameTextInput'u kullanabilir. Kullanım talimatları, GameActivity sayfasında eksiksiz olarak belgelenmiştir. GameActivity ve GameTextInput entegrasyonu örneği için games-samples deposuna bakın. Bu kullanım modeli bu kılavuzun kapsamı dışındadır.

  • Bağımsız bir kitaplık olarak: Kılavuzun geri kalanında kullanım adımları açıklanmaktadır.

Bu iki yöntemin birbirini dışladığını unutmayın.

Resmi GameTextInput sürümleri, Google Maven'daki Jetpack Games kitaplığı sürümünde mevcuttur.

Derlemenizi ayarlama

GameTextInput, Android Arşivi (AAR) olarak dağıtılır. Bu AAR, Java sınıflarını ve GameTextInput'in yerel özelliklerini uygulayan C kaynak kodunu içerir. Bu kaynak dosyaları, yerel kitaplıkları ve kaynak kodunu CMake projenize veya NDK derlemenize sunan Prefab aracını kullanarak derleme sürecinizin bir parçası olarak eklemeniz gerekir.

  1. GameTextInput kitaplık bağımlılığını oyununuzun build.gradle dosyasına eklemek için Jetpack Android Games sayfasındaki talimatları uygulayın. Uygulamalarınız GameActivity kullanıyorsa bağımsız GameTextInput kitaplığını kullanamayacağını unutmayın.

  2. gradle.properties dosyasının aşağıdaki satırları içerdiğinden emin olun:

    # 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 paketini içe aktarın ve projenizin CMakeLists.txt dosyasındaki hedefinize ekleyin:

    find_package(game-text-input REQUIRED CONFIG)
    ...
    target_link_libraries(... game-text-input::game-text-input)
    
  4. Oyununuzdaki .cpp dosyalarından birine, GameTextInput uygulamasını eklemek için aşağıdaki satırı ekleyin:

    #include <game-text-input/gametextinput.cpp>
    
  5. GameTextInput C API'sini kullanan kaynak dosyalara üstbilgi dosyasını ekleyin:

    #include <game-text-input/gametextinput.h>
    
  6. Uygulamayı derleyip çalıştırın. CMake hataları alırsanız AAR ve build.gradle dosyalarının doğru şekilde ayarlandığını doğrulayın. #include dosyası bulunamazsa CMakeLists.txt yapılandırma dosyanızı doğrulayın.

Derlemenizi entegre etme

  1. JVM'ye zaten bağlı olan C iş parçacığınızdan veya uygulamanın ana iş parçacığından JNIEnv işaretçisiyle GameTextInput_init işlevini çağırın.

    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'e erişimi olan bir InputEnabledTextView Java sınıfı oluşturun.

    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. Oluşturulan InputEnabledTextView öğesini kullanıcı arayüzü yerleşimine ekleyin. Örneğin, activity_main.xml içindeki aşağıdaki kod, banner'ı ekranın alt kısmına yerleştirebilir:

    <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 etkinliğinizde InputEnabledTextView örneğini alın. Görünüm Bağlama'yı kullandığınızda bu işlem nispeten basittir:

    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 kitaplığınızda inputConnection değerini GameTextInput_setInputConnection işlevine iletin. Etkinliklerin C durumu yapısı GameTextInputState olarak bildirilmesi için GameTextInput_setEventCallback içinde bir geri çağırma iletin.

    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 kitaplığınızda, uygulamanızın durum değiştiğinde etkinlikleri işlemesi için önceki adımda kaydedilen geri çağırma işlevinizi dahili olarak çağıran GameTextInput_processEvent işlevini çağırın.

    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);
    }
    

Hizmet işlevleri

GameTextInput kitaplığı, Java durum nesneleri ile C durum yapıları arasında dönüşüm yapmanızı sağlayan yardımcı işlevler içerir. GameTextInput_showIme ve GameTextInput_hideIme işlevleri aracılığıyla IME'yi gösterme ve gizleme işlevine erişin.

Referanslar

Geliştiriciler, GameTextInput ile uygulama oluştururken aşağıdaki bilgileri faydalı bulabilir:

Geri bildirim

GameTextInput ile ilgili sorunlar ve sorular için Google IssueTracker'da hata kaydı oluşturun.