텍스트 입력란의 스타일러스 입력

Jetpack androidx.compose.material3 드림 라이브러리를 사용하면 사용자는 TextField 구성 요소에 스타일러스를 사용하는 모든 앱에 적합합니다.

그림 1. 스타일러스를 사용한 필기 입력

기본적으로 스타일러스 입력을 사용 설정하려면 라이브러리 종속 항목을 앱의 build.gradle 파일:

Kotlin

dependencies {
    implementation("androidx.compose.foundation:foundation:LATEST_COMPOSE_VERSION")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "LATEST_EXTENSION_VERSION"
    }

    kotlinOptions {
        jvmTarget = "LATEST_JVM_VERSION"
    }
}

Groovy

dependencies {
    implementation 'androidx.compose.foundation:foundation:LATEST_COMPOSE_VERSION'
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = 'LATEST_EXTENSION_VERSION'
    }

    kotlinOptions {
        jvmTarget = 'LATEST_JVM_VERSION'
    }
}

TextField

스타일러스 필기 입력은 모든 TextField 구성요소에 기본적으로 사용 설정됩니다. Android 14 이상 및 androidx.compose.foundation:foundation:1.7.0 종속됩니다. 스타일러스가 움직일 때 TextField에 필기 입력 모드가 시작됩니다. 이벤트가 구성요소의 필기 입력 경계 내에서 감지됩니다.

필기 입력 경계에는 세로 패딩 40dp, 가로 10dp가 포함됩니다. 입력 필드 주위에 패딩이 있습니다.

그림 2. TextField 구성요소의 필기 입력 경계

입력 방법인 경우 TextField 필드에 스타일러스 필기 입력이 지원되지 않습니다. KeyboardType.Password로 편집기를 요청합니다.

입력 위임

앱은 텍스트 입력란처럼 보이는 자리표시자 UI 요소를 표시할 수 있지만 사실은 텍스트 입력 기능이 없는 정적 UI 요소일 뿐입니다. 검색 필드가 일반적인 예입니다. 정적 UI 요소를 탭하면 전환 트리거 입력에 중점을 둔 기능적 텍스트 입력란이 포함된 새로운 UI로 변경되었습니다.

그림 3. 정적 UI 요소에서 텍스트 입력란으로의 입력 위임

스타일러스 입력 위임

필기 입력 위임 API를 사용하여 다음 작업에 대한 스타일러스 필기 입력 지원 자리표시자 입력란 (handwritingDetector 및 handwritingHandler) 자리표시자 UI 요소는 기능 입력 필드에 필기 입력을 위임하도록 구성되어 있습니다. 예를 들면 다음과 같습니다. 자세한 내용은 HandwritingDetectorSample.kt

스타일러스 필기 입력 모드는 기능 입력란이 포커스를 맞추고 를 만듭니다. InputConnection

그림 4. 정적 UI 요소에서 텍스트 입력 필드로 스타일러스 입력 위임

테스트

스타일러스 필기 입력은 호환되는 스타일러스 입력 장치 및 입력 방법 편집기 (IME)를 Android 14 스타일러스 필기 입력 API를 지원합니다.

스타일러스 입력 기기가 없는 경우 어느 기기에서나 스타일러스 입력을 시뮬레이션합니다. 다음 Android 디버그 브리지를 사용하는 루트 액세스 권한 (에뮬레이터 포함) (adb) 명령어:

// Android 14
adb shell setprop persist.debug.input.simulate_stylus_with_touch true && adb shell stop && adb shell start

// Android 15 and higher
// Property takes effect after screen reconfiguration such as orientation change.
adb shell setprop debug.input.simulate_stylus_with_touch true

지원되지 않는 기기를 사용하는 경우 Gboard 베타를 사용하여 테스트해 보세요 스타일러스.

추가 리소스

• Material Design — 텍스트 필드
• 사용자 입력 처리