按键定义
备注
本文档提供GetPlayerKeys和OnPlayerKeyStateChange使用的按键常量信息。
SA-MP 使用位掩码技术检测按键状态，关于位掩码的详细说明请参阅：位掩码技术解析
| 宏定义 | 数值 | 步行嵌入代码 (6) | 车辆嵌入代码 (6) | 步行默认按键 | 车辆默认按键 |
|---|---|---|---|---|---|
| KEY_ACTION | 1 | ~k~~PED_ANSWER_PHONE~ | ~k~~VEHICLE_FIREWEAPON_ALT~ | TAB 键 | ALT GR/左 Ctrl/小键盘 0 |
| KEY_CROUCH | 2 | ~k~~PED_DUCK~ | ~k~~VEHICLE_HORN~ | C 键 | H 键/大写锁定键 |
| KEY_FIRE | 4 | ~k~~PED_FIREWEAPON~ | ~k~~VEHICLE_FIREWEAPON~ | 左 Ctrl 键/鼠标左键 | 左 Alt 键 |
| KEY_SPRINT | 8 | ~k~~PED_SPRINT~ | ~k~~VEHICLE_ACCELERATE~ | 空格键 | W 键 |
| KEY_SECONDARY_ATTACK | 16 | ~k~~VEHICLE_ENTER_EXIT~ | ~k~~VEHICLE_ENTER_EXIT~ | 回车键 | 回车键 |
| KEY_JUMP | 32 | ~k~~PED_JUMPING~ | ~k~~VEHICLE_BRAKE~ | 左 Shift 键 | S 键 |
| KEY_LOOK_RIGHT | 64 | - | ~k~~VEHICLE_LOOKRIGHT~ | - | E 键 |
| KEY_HANDBRAKE/KEY_AIM(1) | 128 | ~k~~PED_LOCK_TARGET~ | ~k~~VEHICLE_HANDBRAKE~ | 鼠标右键 | 空格键 |
| KEY_LOOK_LEFT | 256 | - | ~k~~VEHICLE_LOOKLEFT~ | - | Q 键 |
| KEY_LOOK_BEHIND | 512 | ~k~~PED_LOOKBEHIND~ | ~k~~VEHICLE_LOOKBEHIND~ | 小键盘 1/鼠标中键 | 2 键 |
| KEY_SUBMISSION | 512 | - | ~k~~TOGGLE_SUBMISSIONS~ | 小键盘 1/鼠标中键 | 2 键/小键盘+ |
| KEY_WALK | 1024 | ~k~~SNEAK_ABOUT~ | - | 左 Alt 键 | - |
| KEY_ANALOG_UP | 2048 | - | ~k~~VEHICLE_TURRETUP~ | 小键盘 8(5) | 小键盘 8 |
| KEY_ANALOG_DOWN | 4096 | - | ~k~~VEHICLE_TURRETDOWN~ | 小键盘 2(5) | 小键盘 2 |
| KEY_ANALOG_LEFT | 8192 | ~k~~VEHICLE_LOOKLEFT~ | ~k~~VEHICLE_TURRETLEFT~ | 小键盘 4 | 小键盘 4 |
| KEY_ANALOG_RIGHT | 16384 | ~k~~VEHICLE_LOOKRIGHT~ | ~k~~VEHICLE_TURRETRIGHT~ | 小键盘 6 | 小键盘 6 |
| KEY_YES(2) | 65536 | ~k~~CONVERSATION_YES~ | ~k~~CONVERSATION_YES~ | Y 键 | Y 键 |
| KEY_NO(2) | 131072 | ~k~~CONVERSATION_NO~ | ~k~~CONVERSATION_NO~ | N 键 | N 键 |
| KEY_CTRL_BACK(2) | 262144(4) | ~k~~GROUP_CONTROL_BWD~ | ~k~~GROUP_CONTROL_BWD~ | H 键 | H 键 |
| UNDEFINED(3) | - | ~k~~GROUP_CONTROL_FWD~ | ~k~~GROUP_CONTROL_FWD~ | G 键 | G 键 |
| KEY_UP | -128 | ~k~~GO_FORWARD~ | ~k~~VEHICLE_STEERUP~ | 上方向键 | 上方向键 |
| KEY_DOWN | 128 | ~k~~GO_BACK~ | ~k~~VEHICLE_STEERDOWN~ | 下方向键 | 下方向键 |
| KEY_LEFT | -128 | ~k~~GO_LEFT~ | ~k~~VEHICLE_STEERLEFT~ | 左方向键 | 左方向键 |
| KEY_RIGHT | 128 | ~k~~GO_RIGHT~ | ~k~~VEHICLE_STEERRIGHT~ | 右方向键 | 右方向键 |
**(1)** 该宏未在 SA-MP 头文件中定义，需手动添加：
#define KEY_AIM KEY_HANDBRAKE
或直接使用 KEY_HANDBRAKE
**(2)** 玩家处于观战模式时无法检测这些按键
**(3)** GROUP_CONTROL_FWD 在 SA-MP 中用于乘客进入车辆，无法直接检测，但其游戏文本定义仍存在
**(4)** 若键值 262144 无效，可使用键值 2 替代
**(5)** 仅在控制器设置为"JOYPAD"时生效