按键映射

按键映射是键盘个性化的基础需求。在大部分客制化键盘玩家的概念里，可以独立设置每个按键的功能，是客制化键盘最为鲜明的特点之一，我们通常把这项功能特性称为全键自定义。

全键自定义，意味着你可以根据自己的偏好，自定义每一个按键的键值。

基础

按键映射的过程非常简单，首先你需要在右侧的键盘中选中要映射的按键，然后在左侧列表中点击你想要设置的键值，即可完成一个按键的映射流程，键值的更新将立即生效。

层级切换

键盘的每个按键在不同“层”上可以定义不同的功能。可以把层想象成叠加在一起的透明薄膜，每一层上都印有不同的键值。当你按下某个键时，键盘会从当前激活的层中读取该键对应的功能。

默认情况下，键盘处于基础层（通常为层 0），这里定义了常规的按键。

通过切换层，可以临时或永久地改变按键的功能，实现类似 Fn 键的效果，或者创建多个功能层，比如游戏层、编程层、媒体控制层等。

• MO(0) - 按住时激活层 0，松开回到原层

• MO(1) - 按住时激活层 1，松开回到原层

• MO(2) - 按住时激活层 2，松开回到原层

• MO(3) - 按住时激活层 3，松开回到原层

• MO(4) - 按住时激活层 4，松开回到原层

• MO(5) - 按住时激活层 5，松开回到原层

• MO(6) - 按住时激活层 6，松开回到原层

• MO(7) - 按住时激活层 7，松开回到原层

• DF(0) - 将层 0 设为默认层

• DF(1) - 将层 1 设为默认层

• DF(2) - 将层 2 设为默认层

• DF(3) - 将层 3 设为默认层

• DF(4) - 将层 4 设为默认层

• DF(5) - 将层 5 设为默认层

• DF(6) - 将层 6 设为默认层

• DF(7) - 将层 7 设为默认层

• TG(0) - 按下时激活层 0，再次按下时关闭层 0

• TG(1) - 按下时激活层 1，再次按下时关闭层 1

• TG(2) - 按下时激活层 2，再次按下时关闭层 2

• TG(3) - 按下时激活层 3，再次按下时关闭层 3

• TG(4) - 按下时激活层 4，再次按下时关闭层 4

• TG(5) - 按下时激活层 5，再次按下时关闭层 5

• TG(6) - 按下时激活层 6，再次按下时关闭层 6

• TG(7) - 按下时激活层 7，再次按下时关闭层 7

• TT(0) - 轻按切换层 0 的开关，连续轻按多次激活层 0

• TT(1) - 轻按切换层 1 的开关，连续轻按多次激活层 1

• TT(2) - 轻按切换层 2 的开关，连续轻按多次激活层 2

• TT(3) - 轻按切换层 3 的开关，连续轻按多次激活层 3

• TT(4) - 轻按切换层 4 的开关，连续轻按多次激活层 4

• TT(5) - 轻按切换层 5 的开关，连续轻按多次激活层 5

• TT(6) - 轻按切换层 6 的开关，连续轻按多次激活层 6

• TT(7) - 轻按切换层 7 的开关，连续轻按多次激活层 7

• TO(0) - 关闭除层 0 以外的所有非默认层，让键盘完全使用层 0 的映射

• TO(1) - 关闭除层 1 以外的所有非默认层，让键盘完全使用层 1 的映射

• TO(2) - 关闭除层 2 以外的所有非默认层，让键盘完全使用层 2 的映射

• TO(3) - 关闭除层 3 以外的所有非默认层，让键盘完全使用层 3 的映射

• TO(4) - 关闭除层 4 以外的所有非默认层，让键盘完全使用层 4 的映射

• TO(5) - 关闭除层 5 以外的所有非默认层，让键盘完全使用层 5 的映射

• TO(6) - 关闭除层 6 以外的所有非默认层，让键盘完全使用层 6 的映射

• TO(7) - 关闭除层 7 以外的所有非默认层，让键盘完全使用层 7 的映射

• OSL(0) - 按一次后，接下来按下的任意键都使用层 0 的定义，之后恢复正常

• OSL(1) - 按一次后，接下来按下的任意键都使用层 1 的定义，之后恢复正常

• OSL(2) - 按一次后，接下来按下的任意键都使用层 2 的定义，之后恢复正常

• OSL(3) - 按一次后，接下来按下的任意键都使用层 3 的定义，之后恢复正常

• OSL(4) - 按一次后，接下来按下的任意键都使用层 4 的定义，之后恢复正常

• OSL(5) - 按一次后，接下来按下的任意键都使用层 5 的定义，之后恢复正常

• OSL(6) - 按一次后，接下来按下的任意键都使用层 6 的定义，之后恢复正常

• OSL(7) - 按一次后，接下来按下的任意键都使用层 7 的定义，之后恢复正常

鼠标模拟

鼠标模拟即通过按键模拟鼠标的各种操作。

• Mouse ↑ - 向上移动光标

• Mouse ↓ - 向下移动光标

• Mouse ← - 向左移动光标

• Mouse → - 向右移动光标

• Mouse Btn1 - 按下按键 1

• Mouse Btn2 - 按下按键 2

• Mouse Btn3 - 按下按键 3

• Mouse Btn4 - 按下按键 4

• Mouse Btn5 - 按下按键 5

• Mouse Btn6 - 按下按键 6

• Mouse Btn7 - 按下按键 7

• Mouse Btn8 - 按下按键 8

• Mouse Wh↑ - 向上滚动滚轮

• Mouse Wh↓ - 向下滚动滚轮

• Mouse Wh← - 向左滚动滚轮

• Mouse Wh→ - 向右滚动滚轮

• Mouse Acc0 - 设置速度为 0

• Mouse Acc1 - 设置速度为 1

• Mouse Acc2 - 设置速度为 2

高级按键

我们在键值菜单中可以找到高级按键的页签。这些按键不同于其他按键，通常需要通过简单的对话框来完成编辑。

Mod-Tap

当按住 Mod-Tap 键 MT(mod, kc) 时，它会作为修饰键（modifier）的功能，而在轻按时则作为普通按键键码（keycode）的功能。

MT(MOD_LCTL | MOD_LSFT, KC_ESC)

该按键在按住时会激活左 Control 和左 Shift ，并在轻按时发送 Escape 键。

Modifier Keys

MK(mod, kc) 可以将修饰键和基础按键组合起来。按下时，首先发送修饰键的 keydown 事件，然后发送按键代码。释放时，先发送按键代码的 keyup 事件，然后发送修饰键。

使用 MK(mod, kc) 的直观感受就好像是同时按下了修饰键和基础按键，如果你不想使用宏来模拟按键动作，这个按键在很多时候可以替代一些组合键。

MK(MOD_LCTL | MOD_LALT, KC_DEL)

该按键在按下时会在激活左 Control 和左 Alt 的同时发送 Delete 键。

Endpoint

TIP

该部分按键适用于 Marin Firmware 内核

在键盘的选项里我们可以找到输出选项，通过点击下拉框可以选择USB或者蓝牙为键盘的首选输出。

在键盘同时连接着USB和蓝牙的时候，键盘将根据该选项，向首选的端点输出数据报文，例如键盘连接USB时，优先向蓝牙端点输出报文数据。

在高级按键里可以找到3个端点控制按键用于通过键盘按键快速的切换首先输出：

• Endpoint Toggle：在USB和蓝牙输出之间来回切换
• Endpoint USB：将首选输出切换到USB端点
• Endpoint BLE：将首先输出切换到蓝牙端点

我们可以在适合的键位设置这些按键，更加快捷的切换首选输出。

Any

Any 即自定义按键，你可以在对话框中输入键值、带有参数的组合键或者 16 进制格式的数值，LINK 将根据你的输入自动计算生成对应的按键。