이전 목록으로
#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

산업용 바코드 스캐너는 앱과 BLE GATT로 직접 통신하기도 하지만, 많은 장비는 Android에 키보드처럼 연결되는 HID 모드를 제공한다. HID 모드에서는 스캔 결과가 일반 키 입력으로 들어오므로 먼저 시스템에 등록된 입력 장치 정보를 확인하면 현장 장비 진단에 도움이 된다.

HID와 BLE GATT의 차이

구분 HID 키보드 모드 BLE GATT 모드
Android에서 보이는 형태 InputDevice·키보드 BluetoothDevice·GATT 서비스
입력 수신 KeyEvent Characteristic notify/read
별도 앱 연결 대체로 불필요 스캔·연결·서비스 탐색 필요
장점 구현이 단순하고 입력 필드와 호환 장비 상태와 프로토콜 제어 가능
주의점 일반 키보드와 구분이 어려움 Bluetooth 권한과 재연결 처리 필요

InputDevice 목록 조회는 이미 Android 입력 장치로 등록된 HID 장비를 확인하는 기능이다. 주변 BLE 장치를 검색하는 BluetoothLeScanner와는 목적이 다르다.

조회 흐름

flowchart TD
    A[InputManager] --> B[입력 장치 ID 목록]
    B --> C[InputDevice 조회]
    C --> D{가상 장치?}
    D -- 예 --> E[필요 시 제외]
    D -- 아니오 --> F[Source·KeyboardType 확인]
    F --> G[키보드·포인터·외부 장치 분류]
    G --> H[진단 화면 또는 이벤트 필터에 활용]

입력 장치 모델

Map보다 타입을 사용하면 호출부에서 필드 이름이나 자료형을 잘못 사용하는 문제를 줄일 수 있다.

data class InputDeviceInfo(
    val id: Int,
    val name: String,
    val descriptor: String,
    val vendorId: Int,
    val productId: Int,
    val sources: Int,
    val keyboardType: Int,
    val isExternal: Boolean,
    val isVirtual: Boolean,
    val isKeyboard: Boolean,
    val isPointer: Boolean,
)

현재 입력 장치 목록 조회

import android.content.Context
import android.hardware.input.InputManager
import android.view.InputDevice

class DeviceConnectManager(context: Context) {
    private val inputManager =
        context.getSystemService(Context.INPUT_SERVICE) as InputManager

    fun listInputDevices(): List<InputDeviceInfo> =
        inputManager.inputDeviceIds.mapNotNull { deviceId ->
            inputManager.getInputDevice(deviceId)?.toInfo()
        }

    private fun InputDevice.toInfo(): InputDeviceInfo {
        val keyboard = supportsSource(InputDevice.SOURCE_KEYBOARD)
        val pointer =
            supportsSource(InputDevice.SOURCE_MOUSE) ||
                supportsSource(InputDevice.SOURCE_TOUCHPAD) ||
                supportsSource(InputDevice.SOURCE_STYLUS)

        return InputDeviceInfo(
            id = id,
            name = name,
            descriptor = descriptor,
            vendorId = vendorId,
            productId = productId,
            sources = sources,
            keyboardType = keyboardType,
            isExternal = isExternal,
            isVirtual = isVirtual,
            isKeyboard = keyboard,
            isPointer = pointer,
        )
    }
}

sources는 단일 enum이 아니라 여러 입력 Source가 결합된 비트 필드다. 다음처럼 sources == SOURCE_KEYBOARD로 비교하면 복합 장치를 놓칠 수 있으므로 supportsSource() 또는 비트 연산을 사용한다.

val isKeyboard = device.supportsSource(InputDevice.SOURCE_KEYBOARD)

// 동일한 의미의 비트 검사
val isKeyboardByMask =
    device.sources and InputDevice.SOURCE_KEYBOARD ==
        InputDevice.SOURCE_KEYBOARD

주요 필드 의미

필드 설명 주의점
id 현재 연결 세션에서 장치를 가리키는 ID 재연결 후 바뀔 수 있으므로 영구 식별자로 저장하지 않는다.
name 시스템이 제공하는 장치 이름 제조사·펌웨어에 따라 달라질 수 있다.
descriptor 입력 장치 descriptor 앱 전용 영구 UUID로 간주하지 않는다.
vendorId USB/Bluetooth 등의 Vendor ID 제공되지 않으면 0일 수 있다.
productId Vendor 내부 Product ID 제공되지 않으면 0일 수 있다.
sources 키보드·마우스 등 지원 Source 비트 필드 복합 장치는 여러 Source를 동시에 가진다.
keyboardType 없음·비영문·영문 키보드 분류 바코드 스캐너 여부를 직접 나타내지 않는다.
isExternal 외부 버스로 연결된 장치 여부 외부 장치라고 모두 스캐너인 것은 아니다.
isVirtual 가상 입력 장치 여부 소프트웨어·시스템 가상 키보드 제외에 활용한다.

Compose 화면에 표시하기

@Composable
fun InputDeviceList(
    devices: List<InputDeviceInfo>,
    modifier: Modifier = Modifier,
) {
    LazyColumn(modifier = modifier) {
        items(devices, key = { it.id }) { device ->
            ListItem(
                headlineContent = { Text(device.name) },
                supportingContent = {
                    Text(
                        "id=${device.id}, " +
                            "vendor=${device.vendorId}, " +
                            "product=${device.productId}, " +
                            "keyboard=${device.isKeyboard}, " +
                            "pointer=${device.isPointer}"
                    )
                },
            )
        }
    }
}

화면 최초 진입 때 한 번만 조회하면 실행 중 연결되거나 해제된 장치가 반영되지 않는다. 연결 상태가 바뀌는 화면이라면 InputDeviceListener를 등록한다.

연결·해제 변경 감지

class InputDeviceMonitor(
    context: Context,
    private val onChanged: () -> Unit,
) : InputManager.InputDeviceListener {

    private val inputManager =
        context.getSystemService(Context.INPUT_SERVICE) as InputManager

    fun start() {
        inputManager.registerInputDeviceListener(this, null)
        onChanged()
    }

    fun stop() {
        inputManager.unregisterInputDeviceListener(this)
    }

    override fun onInputDeviceAdded(deviceId: Int) = onChanged()

    override fun onInputDeviceChanged(deviceId: Int) = onChanged()

    override fun onInputDeviceRemoved(deviceId: Int) = onChanged()
}

onInputDeviceChanged()가 호출되면 이전 InputDevice 객체를 계속 사용하지 말고 getInputDevice(deviceId)로 정보를 다시 조회한다. Activity나 Compose 화면의 onStart·onStop, 또는 DisposableEffect에서 등록과 해제를 대칭적으로 관리한다.

@Composable
fun InputDeviceScreen(manager: DeviceConnectManager) {
    var devices by remember { mutableStateOf(manager.listInputDevices()) }
    val context = LocalContext.current

    DisposableEffect(context, manager) {
        val monitor = InputDeviceMonitor(context) {
            devices = manager.listInputDevices()
        }
        monitor.start()

        onDispose {
            monitor.stop()
        }
    }

    InputDeviceList(devices = devices)
}

실제 앱에서는 콜백 스레드와 Compose 상태 갱신 스레드를 확인하고, 필요하면 Main Looper의 Handler를 등록하거나 ViewModel로 이벤트를 전달한다.

특정 키 이벤트의 발생 장치 확인

목록에 키보드가 여러 개 있다면 실제 키 이벤트의 deviceId를 이용해 어느 장치에서 입력이 들어왔는지 확인할 수 있다.

override fun dispatchKeyEvent(event: KeyEvent): Boolean {
    val device = event.device

    Log.d(
        "InputDevice",
        "deviceId=${event.deviceId}, " +
            "name=${device?.name}, " +
            "vendorId=${device?.vendorId}, " +
            "productId=${device?.productId}, " +
            "keyCode=${event.keyCode}"
    )

    return super.dispatchKeyEvent(event)
}

이 방식은 장치 목록을 추측하는 것보다 실제 입력 출처를 확인하는 데 유용하다. 다만 장치 ID는 연결 세션 중의 식별자이므로 재연결을 고려해야 한다.

HID 바코드 스캐너 판별의 한계

Android는 InputDevice에 “바코드 스캐너”라는 표준 분류를 제공하지 않는다. 따라서 다음 정보는 스캐너 후보를 좁히는 힌트일 뿐 확정 조건이 아니다.

  • isExternal == true
  • supportsSource(SOURCE_KEYBOARD) == true
  • 알고 있는 vendorId와 productId
  • 사전에 확인한 장치 name 또는 descriptor
  • 짧은 시간에 연속된 문자 입력 후 Enter가 오는 패턴

일반 외장 키보드도 같은 조건을 만족할 수 있다. 제조사별 허용 목록을 사용한다면 모델·펌웨어 변경과 ID 미제공 상황을 함께 처리해야 한다.

data class HidDeviceKey(
    val vendorId: Int,
    val productId: Int,
)

private val supportedScanners = setOf(
    HidDeviceKey(vendorId = 0x1234, productId = 0x0001),
)

fun InputDevice.isSupportedScanner(): Boolean =
    isExternal &&
        supportsSource(InputDevice.SOURCE_KEYBOARD) &&
        HidDeviceKey(vendorId, productId) in supportedScanners

위 숫자는 예시이므로 실제 장비에서 확인한 값으로 교체해야 한다. ID가 0인 장치를 이름만으로 신뢰하거나, 미등록 장치의 입력을 보안상 안전하다고 가정하면 안 된다.

권한과 개인정보

이미 시스템 입력 장치로 등록된 장치를 InputManager로 열거하는 작업 자체는 BLE 주변 장치 스캔과 다르다. 반면 앱이 BLE GATT 장치를 직접 검색하고 연결한다면 Android 버전에 맞는 Bluetooth 런타임 권한과 GATT 연결 흐름이 별도로 필요하다.

입력 장치 이름, Vendor ID, Product ID와 이벤트 로그는 진단에 유용하지만 운영 로그에 장기간 저장할 필요가 있는지 검토한다. 실제 스캔 데이터가 개인정보나 업무상 민감한 값일 수 있으므로 원문을 무조건 로그에 남기지 않는다.

실무 체크리스트

  • sources를 동등 비교하지 않고 supportsSource()로 검사한다.
  • 가상 장치와 외부 장치를 구분한다.
  • 장치 ID를 영구 식별자로 저장하지 않는다.
  • Vendor/Product ID가 0일 수 있음을 처리한다.
  • 연결 변경 리스너를 화면 생명주기에 맞춰 해제한다.
  • 실제 KeyEvent.deviceId로 입력 출처를 확인한다.
  • HID 스캐너와 일반 키보드를 완벽히 구분할 수 없다는 전제로 설계한다.
  • BLE GATT 검색과 HID 입력 장치 조회를 같은 기능으로 취급하지 않는다.
  • 바코드 원문과 장치 식별 정보를 불필요하게 운영 로그에 남기지 않는다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.

#Android#Gradle

Android Release 빌드: APK·AAB·서명·R8까지

`assembleRelease`와 `bundleRelease`의 차이, 릴리스 서명, R8 최적화와 배포 전 검증을 정리한다.