키보드 작업 처리

사용자가 EditText 요소와 같은 수정 가능한 텍스트 뷰에 포커스를 맞추는 경우 하드웨어 키보드가 연결되어 있으면 모든 입력이 시스템에서 처리됩니다. 하지만 앱에서 키보드 입력을 가로채거나 직접 처리하게 만들려면 KeyEvent.Callback 인터페이스에서 onKeyDown()과 onKeyMultiple() 같은 콜백 메서드를 구현하면 됩니다.

Activity 클래스와 View 클래스 모두 KeyEvent.Callback 인터페이스를 구현하므로, 일반적으로 이 클래스의 확장에서 적절하게 콜백 메서드를 재정의해야 합니다.

참고: KeyEvent 클래스 및 관련 API를 사용하여 키보드 이벤트를 처리할 때 키보드 이벤트가 하드웨어 키보드에서만 발생한다고 예상해야 합니다. 소프트 입력 방법(터치 키보드)에서 발생하는 키 이벤트를 수신한다고 생각해서는 안 됩니다.

단일 키 이벤트 처리

개별 키 누르기를 처리하려면 onKeyDown() 또는 onKeyUp()을 적절하게 구현합니다. 이벤트를 하나만 수신하려면 대개 onKeyUp()을 사용해야 합니다. 사용자가 버튼을 길게 누르는 경우에는 onKeyDown()이 여러 번 호출됩니다.

예를 들어 다음 구현은 게임을 제어하는 일부 키보드 키에 응답합니다.

    override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
        return when (keyCode) {
            KeyEvent.KEYCODE_D -> {
                moveShip(MOVE_LEFT)
                true
            }
            KeyEvent.KEYCODE_F -> {
                moveShip(MOVE_RIGHT)
                true
            }
            KeyEvent.KEYCODE_J -> {
                fireMachineGun()
                true
            }
            KeyEvent.KEYCODE_K -> {
                fireMissile()
                true
            }
            else -> super.onKeyUp(keyCode, event)
        }
    }
    

    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        switch (keyCode) {
            case KeyEvent.KEYCODE_D:
                moveShip(MOVE_LEFT);
                return true;
            case KeyEvent.KEYCODE_F:
                moveShip(MOVE_RIGHT);
                return true;
            case KeyEvent.KEYCODE_J:
                fireMachineGun();
                return true;
            case KeyEvent.KEYCODE_K:
                fireMissile();
                return true;
            default:
                return super.onKeyUp(keyCode, event);
        }
    }
    

특수키 처리

키를 Shift 키나 Control 키와 함께 사용하는 작업처럼 특수키 이벤트에 응답하려면 콜백 메서드에 전달된 KeyEvent를 쿼리하면 됩니다. getModifiers() 및 getMetaState()와 같은 몇 가지 메서드를 통해 특수키와 관련된 정보를 얻을 수 있습니다. 하지만 가장 간단한 방법은 isShiftPressed()와 isCtrlPressed() 같은 메서드를 통해 중요한 특수키가 정확히 눌렸는지를 확인하는 것입니다.

예를 들어 다시 onKeyDown() 구현을 살펴보세요. Shift 키를 누른 채로 또 다른 키를 사용할 경우 이를 어떻게 추가적으로 처리할 수 있는지를 보여줍니다.

    override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
        return when (keyCode) {
            ...
            KeyEvent.KEYCODE_J -> {
                if (event.isShiftPressed) {
                    fireLaser()
                } else {
                    fireMachineGun()
                }
                true
            }
            KeyEvent.KEYCODE_K -> {
                if (event.isShiftPressed) {
                    fireSeekingMissle()
                } else {
                    fireMissile()
                }
                true
            }
            else -> super.onKeyUp(keyCode, event)
        }
    }
    

    @Override
    public boolean onKeyUp(int keyCode, KeyEvent event) {
        switch (keyCode) {
            ...
            case KeyEvent.KEYCODE_J:
                if (event.isShiftPressed()) {
                    fireLaser();
                } else {
                    fireMachineGun();
                }
                return true;
            case KeyEvent.KEYCODE_K:
                if (event.isShiftPressed()) {
                    fireSeekingMissle();
                } else {
                    fireMissile();
                }
                return true;
            default:
                return super.onKeyUp(keyCode, event);
        }
    }