이 페이지는 Cloud Translation API를 통해 번역되었습니다.

게임 텍스트 입력 Android Game Development Kit의 일부

GameTextInput 라이브러리를 사용하면 텍스트 입력을 위해 소프트 키보드를 사용하는 전체 화면 Android 앱 작성이 더 간단해집니다.

GameTextInput은 소프트 키보드를 표시하거나 숨기고, 현재 편집된 텍스트를 설정하거나 가져오고, 텍스트가 변경될 때 알림을 받는 간단한 API를 제공합니다. 이 기능은 본격적인 텍스트 편집기 앱을 위한 것은 아니지만 여전히 게임의 일반적인 사용 사례에 대한 선택 및 구성 영역 지원을 제공합니다. 또한 이 라이브러리는 맞춤법 검사, 완성, 멀티 키 문자와 같은 고급 입력 방식 편집기(IME) 기능을 지원합니다.

내부적으로 GameTextInput는 입력 텍스트를 관련 상태)를 내부 버퍼 GameTextInput::currentState_에 추가하고 알림을 앱에 영향을 주지 않습니다. 그런 다음 앱에서 텍스트 처리를 수행한 후 등록된 콜백함수에 해당합니다.

가용성

GameTextInput는 다음과 같은 방식으로 사용할 수 있습니다.

GameActivity: GameActivity는 GameTextInput을 통합합니다. GameActivity를 사용하는 애플리케이션은 통합된 GameTextInput 사용 안내는 GameActivity 페이지 에서 확인할 수 있습니다. GameActivity 및 GameTextInput 통합 샘플을 보려면 games-samples 저장소에 연결합니다. 이 사용 모델은 이 가이드의 범위에 포함되지 않습니다.
독립형 라이브러리: 가이드의 나머지 부분에서 사용 단계를 설명합니다.

위의 두 메서드는 상호 배타적입니다.

정식 GameTextInput 출시 버전은 다음 채널에서 제공됩니다.

Google Maven에서 Jetpack 게임 라이브러리 출시
AGDK 다운로드 페이지의 ZIP 파일 버전

이 가이드에서는 첫 번째 사용 사례를 설명합니다. ZIP 파일 릴리스를 사용하려면 패키지 안에 함께 들어 있는 안내를 참조하세요.

빌드 설정

GameTextInput는 Android 보관 파일 (AAR)로 배포됩니다. 이 AAR에는 Java 클래스와 GameTextInput의 네이티브 기능을 구현하는 C 소스 코드 나 리소스를 통해 빌드 프로세스의 일부로 이러한 소스 파일을 포함해야 Prefab님, 이렇게 하면 네이티브 라이브러리와 소스 코드를 CMake 프로젝트 또는 NDK 빌드에 노출할 수 있습니다.

Jetpack Android 게임 페이지를 방문하여 게임의 build.gradle 파일에 GameTextInput 라이브러리 종속 항목을 추가합니다. 참고 애플리케이션에서 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>
```
GameTextInput C API를 사용하는 소스 파일에 헤더를 포함합니다. 파일:
```
#include <game-text-input/gametextinput.h>
```
앱을 컴파일하고 실행합니다. CMake 오류가 있으면 AAR 및 build.gradle 파일이 올바르게 설정되었는지 확인합니다. #include 파일을 찾을 수 없는 경우 CMakeLists.txt 구성 파일을 확인합니다.

빌드 통합

이미 JVM에 연결된 C 스레드 또는 앱 기본 스레드, 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);
    ...
}

InputConnection 액세스 권한이 있는 InputEnabledTextView 자바 클래스를 만듭니다.

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를 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" />

새로운 InputEnabledTextView 클래스를 Java 활동으로 가져옵니다. 이것은 뷰 결합을 사용하면 비교적 간단합니다.

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 드림 C 상태 구조체 GameTextInputState로 이벤트에 대한 알림을 받습니다.

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 라이브러리에는 자바 상태 객체와 C 상태 구조 간에 변환할 수 있는 유틸리티 함수가 포함되어 있습니다. 동영상, 이미지, 동영상 등의 및 GameTextInput_showIme를 통해 IME 숨기기 및 GameTextInput_hideIme 함수와 비교합니다.

참조

개발자가 GameTextInput:

의견

GameTextInput에 관한 문제나 질문이 있는 경우 다음을 생성하세요. Google Issue Tracker의 버그가 표시됩니다.