按键模块

键盘按键映射说明

本文件记录了一系列键盘按键与特定 HIDUsage 值的映射关系。这些映射在处理与键盘输入相关的操作时非常有用，尤其是在涉及到需要识别和处理不同键盘按键事件的场景中。

按键名称	`HIDUsage` 值	说明
`RETURN`	`@(kHIDUsage_KeyboardReturnOrEnter)`	回车键
`ESCAPE`	`@(kHIDUsage_KeyboardEscape)`	退出键
`BACKSPACE`	`@(kHIDUsage_KeyboardDeleteOrBackspace)`	退格键
`TAB`	`@(kHIDUsage_KeyboardTab)`	制表键
`SPACE`	`@(kHIDUsage_KeyboardSpacebar)`	空格键
`HYPHEN`	`@(kHIDUsage_KeyboardHyphen)`	连字符
`EQUAL`	`@(kHIDUsage_KeyboardEqualSign)`	等号键
`BRACKETOPEN`	`@(kHIDUsage_KeyboardOpenBracket)`	左方括号键
`BRACKETCLOSE`	`@(kHIDUsage_KeyboardCloseBracket)`	右方括号键
`BACKSLASH`	`@(kHIDUsage_KeyboardBackslash)`	反斜杠键
`SEMICOLON`	`@(kHIDUsage_KeyboardSemicolon)`	分号键
`QUOTATION`	`@(kHIDUsage_KeyboardQuote)`	引号键
`ACCENT`	`@(kHIDUsage_KeyboardGraveAccentAndTilde)`	重音符（`）与波浪线（~）共用键
`COMMA`	`@(kHIDUsage_KeyboardComma)`	逗号键
`DOT`	`@(kHIDUsage_KeyboardPeriod)`	句号键
`SLASH`	`@(kHIDUsage_KeyboardSlash)`	正斜杠键

按键名称	`HIDUsage` 值	说明
`CAPSLOCK`	`@(kHIDUsage_KeyboardCapsLock)`	大写锁定键
`PAUSE`	`@(kHIDUsage_KeyboardPause)`	暂停键
`INSERT`	`@(kHIDUsage_KeyboardInsert)`	插入键
`PAGEUP`	`@(kHIDUsage_KeyboardPageUp)`	向上翻页键
`DELETE`	`@(kHIDUsage_KeyboardDeleteForward)`	删除键（向前删除）
`END`	`@(kHIDUsage_KeyboardEnd)`	行尾键
`PAGEDOWN`	`@(kHIDUsage_KeyboardPageDown)`	向下翻页键
`RIGHTARROW`	`@(kHIDUsage_KeyboardRightArrow)`	右箭头键
`LEFTARROW`	`@(kHIDUsage_KeyboardLeftArrow)`	左箭头键
`DOWNARROW`	`@(kHIDUsage_KeyboardDownArrow)`	下箭头键
`UPARROW`	`@(kHIDUsage_KeyboardUpArrow)`	上箭头键

按键名称	`HIDUsage` 值	说明
`LEFTCONTROL`	`@(kHIDUsage_KeyboardLeftControl)`	左控制键
`LEFTSHIFT`	`@(kHIDUsage_KeyboardLeftShift)`	左 Shift 键
`LEFTALT`	`@(kHIDUsage_KeyboardLeftShift)`	注意：此处疑似映射错误，应为 `@(kHIDUsage_KeyboardLeftAlt)`，左 Alt 键
`LEFTCOMMAND`	`@(kHIDUsage_KeyboardLeftGUI)`	左 Command 键（在 Windows 键盘上可能是 Windows 徽标键）
`RIGHTCONTROL`	`@(kHIDUsage_KeyboardRightControl)`	右控制键
`RIGHTSHIFT`	`@(kHIDUsage_KeyboardRightShift)`	右 Shift 键
`RIGHTALT`	`@(kHIDUsage_KeyboardRightAlt)`	右 Alt 键
`RIGHTCOMMAND`	`@(kHIDUsage_KeyboardRightGUI)`	右 Command 键（在 Windows 键盘上可能是 Windows 徽标键）

按键名称	`HIDUsage` 值	说明
`POWER`	`@(kHIDUsage_Csmr_Power)`	电源键，通常用于控制设备的电源开启或关闭操作。
`HOMEBUTTON`	`@(kHIDUsage_Csmr_Menu)`	主页按钮，可能用于返回设备的主屏幕或主菜单界面。需要注意，这里映射到 `kHIDUsage_Csmr_Menu`，不同设备对其功能的具体定义可能存在差异。
`MUTE`	`@(kHIDUsage_Csmr_Mute)`	静音键，用于快速将设备的音频输出设置为静音状态。
`VOLUMEUP`	`@(kHIDUsage_Csmr_VolumeIncrement)`	音量增加键，按下此键可提高设备的音量大小。
`VOLUMEDOWN`	`@(kHIDUsage_Csmr_VolumeDecrement)`	音量减小键，按下可降低设备的音量。
`HOME`	`@(kHIDUsage_Csmr_MediaSelectHome)`	这里的 `HOME` 键映射到媒体选择主页相关功能，与传统键盘上的 `HOME` 键功能可能不同，主要用于媒体相关操作中的主页选择功能。

这些按键映射在开发涉及设备控制、媒体播放等功能的应用程序时具有重要作用。开发者可以借助这些映射关系，实现对用户按下特定按键的准确捕捉，并执行相应的功能逻辑，如调整音量、控制媒体播放、操作设备电源等。在实际应用中，需根据具体设备和应用场景，对这些按键事件进行合理的处理和优化，以提供更好的用户体验。

HOME 键的映射注释提到，@(kHIDUsage_KeyboardHome) 不完全等同于 iOS 设备的 HOME 键。在实际应用中使用该映射时，需注意其与 iOS 设备 HOME 键功能上的差异。

这些按键映射关系在开发与键盘交互相关的应用程序时，可用于准确识别用户按下的按键，并据此执行相应的操作逻辑。例如，在文本输入处理、快捷键功能实现等场景中，这些映射能够帮助开发者快速定位和处理不同的按键事件。