OBS直播看不清你按了什么键？用input-overlay把键盘和手柄操作变成画面

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

半夜三更，你在直播间复盘一局《只狼》，嘴里念叨着"这波应该先弹刀再踩头"，观众却在弹幕里刷："主播你刚才到底按了什么？""格挡是哪个键？"你才发现，屏幕上只有游戏画面，你的手速再华丽，观众也看不见。

这个问题，正是开源的OBS插件input-overlay要解决的：它能把键盘、游戏手柄、鼠标的实时操作，直接渲染进直播画面。按键按下去就高亮，摇杆推过去就倾斜，观众看得清清楚楚，你不用再靠嘴讲解"我刚才按了啥"。

故事从一次"看不到的格挡"开始

先别急着找下载按钮。我们聊清楚两件事：它解决什么问题，以及它怎么做到。

input-overlay 是一套运行在 OBS Studio 里的输入可视化插件，支持 Windows 和 Linux（64位）。它通过挂钩系统输入事件，把每一次按键、点击、摇杆拨动变成画面元素，叠加在你的场景里。同一个画面里，键盘、手柄、鼠标可以同时显示，互不干扰。

它的工作方式很有意思：你看到的那张"键盘图"和那一份"配置"是分开的——贴图负责长什么样，JSON 配置文件负责"哪个按键在哪个位置、按下去高亮成什么效果"。两者配对使用，就是一套完整的显示方案。

上面这张图就是它在 OBS 里的实际效果：左侧是手柄、右侧是键盘，底部还有一个输入历史列表，连"L CTRL + C"这种组合键都会被记录下来。你可以看到 Sources 面板里同时挂了 Keyboard、Gamepad、Input History 三个来源——这说明"一个场景显示多套输入"是开箱即用的能力。

五分钟，让观众看见你的操作

我们不做"第X步"流水账，只说最省事的一条路。

你大概率属于这类用户：不折腾，就想要个能用的效果。那就直接用项目自带的预设。

预设是现成的"贴图+配置"套装，放在presets/目录里，一眼能认出你手头的设备：

• 标准键盘：presets/qwerty/qwerty.json配qwerty.png
• Xbox 手柄：presets/xbox-controller/xbox-controller.json配对应的 PNG
• PS5 手柄：presets/dualsense/dualsense.json配dualsense.png
• 复古怀旧：presets/nes/NES.json、presets/snes/generic-gamepad.json
• 射击游戏常用的 WASD 区域：presets/wasd/wasd.json

拿到配套文件后，在 OBS 里做三件事：

1. 来源面板点"+"，添加"输入叠加"（Input Overlay）源；
2. 属性里选"配置文件"（JSON）和"贴图文件"（PNG），两个都指到同一个预设目录；
3. 按一下键盘、推一下摇杆，画面里对应的键就该亮了。

就这么简单。如果你同时插了键盘和手柄，就再加一个"输入叠加"源，把另一个预设指进去——一个场景里挂几个输入源完全没问题。

这一套不用改任何代码，是最快能产生"哇，真的能看到我按的键"效果的路径。先跑通它，再谈个性化。

三个真实场景，把功能用出价值

场景一：格斗游戏教学——让观众看清连招节奏

格斗游戏的连招讲究时机，口述"先轻脚后中拳再接必杀"根本说不清楚。用 input-overlay 显示手柄后，观众能看到你每一步按键的先后顺序：哪个键先亮、哪个键后亮、方向键拨动的角度，一目了然。教学效果立刻不同。

场景二：编程教学直播——快捷键不靠嘴说

教别人用 IDE 时，Ctrl+Shift+K这类快捷键你按得飞快，学员根本反应不过来。这时候换个思路：在场景里挂一个全键盘预设，比如presets/qwerty/，你按什么键、什么组合，观众全部看得到。比你在画面上画红圈强多了。

场景三：怀旧游戏直播——复古设备也有显示方案

你以为只有现代手柄有预设？项目里藏着nes/、snes/、gameboy-pixel/、n64-pixel/这些像素风预设，专门给怀旧直播准备的。连 GameCube、街机摇杆（arcade-stick/）、Hitbox 格斗面板（hitbox/）都有配套配置。

如果你用的是不太常见的设备，翻一翻presets/目录，多半能找到惊喜。里面还有鼠标轨迹、鼠标点击、滚轮的显示方案（presets/mouse/），甚至罗技 G502、G602 这种具体型号的鼠标贴图都在。

新手最容易踩的三个坑

坑一：贴图和配置不是配套的

把dualsense.json配上了ds3.png，按键位置全对不上，画面乱七八糟。记住：每个预设目录里的 JSON 和 PNG 是配对出厂的，跨目录混搭大概率翻车。先整个目录一起用，再考虑自定义。

坑二：预设版本和插件版本不匹配

presets/README.md里有一句很重要的提醒：预设只保证和当前版本的插件兼容。你从别处下载了老版本的预设，插件却更新了，可能出现元素不显示或错位。尽量用随插件版本一起发布的那份预设。

坑三：忘了这是"本地钩子"插件

它的原理是挂钩本机输入事件，所以和游戏本身的输入录制是两回事。某些反作弊严格的网游，对外部挂钩比较敏感，开直播玩这类游戏前，建议先确认规则。另外，如果你的直播画面想显示的是"远端某台机器"的输入，项目也支持通过 websocket 转发和接收事件（设置里勾选"通过 websocket 服务器转发和接收事件"即可），但那是进阶玩法，新手先不用碰。

想把键盘布局改成自己习惯的样子？

presets/里的键盘预设大多针对标准 QWERTY。你是 AZERTY 用户？项目里恰好有presets/qwertz_full_size_german/、presets/zqsd-azerty-minimal/这些布局变体。还不够，就自己改 JSON：配置文件本质是一份元素清单，每个元素定义了类型（按钮、摇杆、方向键、鼠标移动等）、坐标、尺寸和按键映射，结构并不复杂。改错位置了也别慌，配置文件是纯文本，改坏了再拿一份原始文件覆盖即可。

如果要深度定制，项目还附带了网页版的配置创建工具（docs/cct/），可视化地摆放元素、生成配置，比手改 JSON 舒服得多。

语言和输入历史：两个常被忽略的细节

插件界面自带多语言，data/locale/里有中文（zh-CN.ini）、德语、法语、俄语、韩语等 9 种语言文件，中文用户直接选简体中文就行，设置项都会变成"贴图文件""配置文件"这样的中文标签。

另外，除了"输入叠加"源，插件还提供了一个"输入历史"源：把最近几次按键以文本或图标形式列在画面上，适合做"观众回看操作"的场景。presets/input-history-windows/目录里还有一个配合浏览器源使用的 HTML 模板，能显示键盘事件流，风格可以自己用 CSS 调整。

回到开头那场直播

还记得那个被观众追问"刚才按了什么"的深夜吗？现在再打一把：你弹刀，画面里的按键亮起来；你踩头，手柄方向键跟着偏。弹幕从"看不懂"变成"学到了"，还有人在问你用的什么插件。

动手清单，照着勾：

• 拿到 input-overlay 的安装包，装进 OBS 插件目录并重启
• 在presets/里找到匹配你设备的预设（键盘、手柄或鼠标）
• 添加"输入叠加"源，指认配套的 JSON 和 PNG
• 测试按键与摇杆，确认显示正常
• （可选）添加第二个输入源，实现键盘手柄同屏
• （可选）把界面语言切到简体中文，研究一下输入历史源

下一次直播，让观众真正"看见"你的操作。从第一次按键高亮开始。

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