Keyboards Shortcuts Helper를 통해 사용자는 앱을 실행할 수 있습니다. 단축키 도우미에서 앱의 바로가기 게시 사용자 생산성과 사용 편의성을 개선하는 방법을 살펴보겠습니다
사용자가 Meta+/를 눌러 단축키 화면을 열 수 있습니다. Android 7.0 (API 수준 24) 이상에서 사용할 수 있습니다.
![기기에서 애플리케이션이 열려 있고 시스템 바로가기를 표시합니다.](https://developer.android.com/static/images/develop/ui/touch-input/keyboard-input/keyboard_shortcut_helper.png?authuser=9&hl=ko)
단축키 도우미 단축키 제공
사용 가능한 단축키 목록을 제공하여
단축키 도우미에서
onProvideKeyboardShortcuts()
창 콜백.
다음 스니펫은
onProvideKeyboardShortcuts()
:
class MainActivity : ComponentActivity() {
// Activity codes such as overridden onStart method.
override fun onProvideKeyboardShortcuts(
data: MutableList<KeyboardShortcutGroup>?,
menu: Menu?,
deviceId: Int
) {
val shortcutGroup = KeyboardShortcutGroup(
"Cursor movement",
listOf(
KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
)
)
data?.add(shortcutGroup)
}
}
KeyboardShortcutInfo
는 단축키를 설명합니다.
단축키 목록은
KeyboardShortcutGroup
객체
앱에서 다음을 추가하여 사용 가능한 단축키를 단축키 도우미에 알립니다.
KeyboardShortcutGroup
객체를 전달된 변경 가능한 목록에 추가합니다.
를 메서드의 첫 번째 매개변수로 사용합니다.
그룹으로 단축키 정리하기
단축키 도우미가 단축키를 별도의 그룹으로 표시 이를 통해 사용자는 사용 사례별 또는 화면별 단축키를 찾을 수 있습니다. 있습니다. 그림 2에 단축키가 나와 있습니다. 커서 이동과 메시지 수정이라는 두 그룹으로 분류됩니다.
![바로가기 그룹을 표시하는 기기에서 애플리케이션이 열려 있습니다.](https://developer.android.com/static/images/develop/ui/touch-input/keyboard-input/keyboard_shortcut_group.png?authuser=9&hl=ko)
앱은
각 그룹의 KeyboardShortcutGroup
객체입니다.
다음 스니펫에서는 두 개의 KeyboardShortCutGroup
객체가
onProvideKeyboardShortcuts()
메서드에 전달된 변경 가능한 목록입니다.
개체는 단축키 도우미에서
그림 2에서 볼 수 있습니다.
override fun onProvideKeyboardShortcuts(
data: MutableList<KeyboardShortcutGroup>?,
menu: Menu?,
deviceId: Int
) {
val cursorMovement = KeyboardShortcutGroup(
"Cursor movement",
listOf(
KeyboardShortcutInfo("Up", KeyEvent.KEYCODE_P, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Down", KeyEvent.KEYCODE_N, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Forward", KeyEvent.KEYCODE_F, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Backward", KeyEvent.KEYCODE_B, KeyEvent.META_CTRL_ON),
)
)
val messageEdit = KeyboardShortcutGroup(
"Message editing",
listOf(
KeyboardShortcutInfo("Select All", KeyEvent.KEYCODE_A, KeyEvent.META_CTRL_ON),
KeyboardShortcutInfo("Send a message", KeyEvent.KEYCODE_ENTER, KeyEvent.META_SHIFT_ON)
)
)
data?.add(cursorMovement)
data?.add(messageEdit)
}
코드에서 단축키 도우미 열기
앱은 키보드 단축키 화면을
requestShowKeyboardShortcuts()
호출
메서드를 사용하여 축소하도록 요청합니다. 다음 스니펫에서 사용자가
또는 버튼을 클릭하거나 Enter 키를 누릅니다.
val activity = LocalContext.current as Activity
Button(onClick = { activity.requestShowKeyboardShortcuts() }) {
Text(text = "Show keyboard shortcuts")
}