直播时观众总问“你按了什么键“？用input-overlay免费给OBS直播画面加上键盘手柄按键显示，3分钟让操作看得见-开发者社区

直播时观众总问"你按了什么键"？用input-overlay免费给OBS直播画面加上键盘手柄按键显示，3分钟让操作看得见

【免费下载链接】input-overlayShow keyboard, gamepad and mouse input on stream项目地址: https://gitcode.com/gh_mirrors/in/input-overlay

深夜两点，你的直播间里弹幕突然刷屏："大佬你刚才搓了个什么连招？""那个快捷键是 Ctrl+Shift+什么的来着？"你手忙脚乱地打字解释，可连招早就打完了，观众依旧一头雾水。这样的"灵魂提问"，几乎每个游戏主播、教学主播都经历过。

其实答案一直很简单：input-overlay，一个免费开源的 OBS 直播插件，能把键盘、鼠标、游戏手柄的每一次操作实时显示在直播画面上。观众从此不再靠猜，你的操作全程"透明化"。这篇文章不讲枯燥的代码，只带你像聊家常一样，把这款按键显示神器装好、配好、玩出花。

第一次听说"按键可视化"：它到底干了一件什么事

你可以把它理解成直播画面里的"游戏操作字幕组"。电影有字幕，让观众听懂台词；input-overlay 就是给操作配字幕，让观众看懂你按下的是哪个键。

它挂在 OBS 里作为一个"输入叠加"源，工作方式很朴素：后台静静监听你的键盘、鼠标和手柄事件，再把按下、松开、连按的状态实时映射到一张贴图上。贴图上的按键会跟着你的手一起亮起、变暗，长按、连击、组合键各有各的脾气。

上面这张就是经典的 QWERTY 全键盘预设，按下哪个键，哪个键就在直播画面里发光。

安装踩坑实录：其实只有"复制文件"这一个动作

很多新手一听"插件"就发怵，觉得要编译、要配环境。实际上安装过程朴素到让人意外——下载、解压、复制、重启，四步走完。

Windows 用户：把解压出的文件放进 OBS 的插件目录（一般在obs-plugins/64bit/下）
Linux 用户：放到~/.config/obs-studio/plugins/目录

重启 OBS 后，在"来源"面板点"+"，如果列表里出现了"输入叠加"这个选项，就说明安装成功，可以进入下一步了。

小提醒：如果装完找不到选项，先确认 OBS 版本和插件位数是否匹配，再检查文件是不是放对了层级，最后一定要重启一次 OBS。

第一次配置成功时的惊喜：选对"皮肤"就能用

真正让我上头的，是 input-overlay 的预设库——光是presets/目录下就有三十多套现成的"皮肤"，几乎覆盖了所有主流设备：

你手里有什么	去哪个目录翻	适合播什么
普通键盘	`qwerty/`、`workman/`	PC 游戏、办公软件教学
只露 WASD	`wasd/`、`wasd-numpad/`	FPS、动作游戏
Xbox 手柄	`xbox-controller/`	Xbox / PC 游戏
PS5 手柄	`dualsense/`	PlayStation 游戏
复古情怀	`nes/`、`snes/`、`gameboy-pixel/`	怀旧游戏直播

配置新源时，通常只需要两样东西：一个.json配置文件（告诉插件按键的位置和逻辑），一张对应的.png贴图（负责"长得好看"）。选好之后拖到屏幕角落，按下键盘，画面里的按键应声亮起——那一刻的成就感，堪比第一次装好 RGB 机箱灯。

越用越有味道：三种进阶玩法打开新世界

装好只是起点，真正让我从"能用"走到"好用"的，是下面这三个进阶玩法。

玩法一：手柄自定义绑定，告别"默认映射对不上"不同手柄的按键排布千奇百怪。在插件设置里有一个"游戏手柄绑定"界面，对准文本区域，按下手柄上对应的按钮，就能把物理按键和你想要的逻辑一一对应起来。摇杆灵敏度、盲区也可以单独调，手柄玩家最头疼的"摇杆漂移导致按键显示乱跳"问题，在这里能直接根治。

玩法二：多设备同屏，观众看得到你的完整操作组合键盘打移动、手柄控制视角、鼠标点选技能——这类混合操作在游戏里很常见。办法是添加多个输入叠加源：一个显示 WASD 区域，一个显示手柄按钮，一个显示鼠标轨迹，三个源叠在一起，观众就能看到你的"左右互搏"全貌。

玩法三：连"输入历史"都给你做出来presets/input-history-windows/目录里藏着一个很妙的模板：它不是静态显示按键状态，而是像打字机一样滚动记录你按过的每一个键，还带重复计数、超时淡出动画。对教学直播来说简直是神器——学员再也不用喊"老师你刚才那个键太快了我没看清"。