鍵盤快速鍵小幫手

鍵盤快速鍵小幫手可讓使用者找到適用於 平台和開啟應用程式在鍵盤快速鍵輔助程式中發布應用程式捷徑 進而提高使用者的工作效率和使用便利性

使用者按下 Meta+/ 鍵即可開啟鍵盤快速鍵畫面， 適用於 Android 7.0 (API 級別 24) 以上版本。

圖 1：鍵盤快速鍵小幫手。

注意： 並非所有鍵盤都顯示 Meta 鍵。在 macOS 鍵盤上 Meta 鍵是 Command 鍵；Windows 鍵盤、Windows 鍵 以及 ChromeOS 鍵盤上的搜尋鍵。

提供鍵盤快速鍵輔助程式的捷徑

你可以提供鍵盤快速鍵清單 使用鍵盤快速鍵輔助功能， 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 顯示鍵盤快速鍵 分成兩組：遊標移動和訊息編輯。

圖 2 鍵盤快速鍵小幫手中的類別。

應用程式會註冊兩個以上的鍵盤快速鍵群組， 每個群組的 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")
}