Xử lý thao tác trên bàn phím

Thử cách dùng Compose
Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách xử lý các thao tác trên bàn phím trong Compose.
Xử lý thao tác trên bàn phím trong Compose →

Khi người dùng đặt tiêu điểm vào một thành phần hiển thị văn bản có thể chỉnh sửa, chẳng hạn như phần tử EditText và người dùng đã gắn bàn phím phần cứng, tất cả dữ liệu đầu vào sẽ do hệ thống xử lý. Tuy nhiên, nếu muốn chặn hoặc tự xử lý trực tiếp dữ liệu đầu vào từ bàn phím, bạn có thể thực hiện việc này bằng cách triển khai các phương thức gọi lại từ giao diện KeyEvent.Callback, chẳng hạn như onKeyDown() và onKeyMultiple().

Cả lớp Activity và View đều triển khai giao diện KeyEvent.Callback, vì vậy, bạn thường ghi đè các phương thức gọi lại trong phần mở rộng của các lớp này (nếu thích hợp).

Lưu ý: Khi xử lý các sự kiện bàn phím bằng lớp KeyEvent và các API có liên quan, hãy dự kiến rằng các sự kiện bàn phím chỉ đến từ bàn phím phần cứng. Tuyệt đối không dựa vào việc nhận sự kiện phím cho bất kỳ phím nào trên phương thức nhập mềm (bàn phím ảo).

Xử lý sự kiện nhấn phím đơn

Để xử lý một thao tác nhấn phím riêng lẻ, hãy triển khai onKeyDown() hoặc onKeyUp() sao cho phù hợp. Thông thường, bạn sẽ sử dụng onKeyUp() nếu muốn đảm bảo rằng bạn chỉ nhận được một sự kiện. Nếu người dùng nhấn và giữ một phím, thì onKeyDown() sẽ được gọi nhiều lần.

Ví dụ: cách triển khai này phản hồi một số phím trên bàn phím để điều khiển trò chơi:

Kotlin

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

Java

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

Xử lý phím bổ trợ

Để phản hồi các sự kiện phím sửa đổi, chẳng hạn như khi một phím được kết hợp với Shift hoặc Control, bạn có thể truy vấn KeyEvent được truyền đến phương thức gọi lại. Một số phương thức cung cấp thông tin về phím bổ trợ, chẳng hạn như getModifiers() và getMetaState(). Tuy nhiên, giải pháp đơn giản nhất là kiểm tra xem phương thức nào đang nhấn chính xác phím sửa đổi mà bạn quan tâm, chẳng hạn như isShiftPressed() và isCtrlPressed().

Ví dụ: dưới đây là cách triển khai onKeyUp() một lần nữa, với cách xử lý bổ sung cho trường hợp nhấn và giữ phím Shift bằng một trong các phím:

Kotlin

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

Java

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

Tài nguyên khác