5分钟让OBS直播实时显示键盘和手柄按键：input-overlay完整上手指南

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

直播打游戏的时候，你有没有被观众问过这样的话："刚才那个操作是怎么按出来的？""你按了哪个键？"——尤其在格斗、速通或教学类直播里，这种问题几乎每场都会出现。你嘴上解释半天，观众还是懵。今天要介绍的 input-overlay，就是一个能把键盘、游戏手柄和鼠标输入实时显示在直播画面里的OBS插件，让你每一轮按键都"看得见"。下文会带你从零装好它，并讲清它背后的工作方式。

先别急着读原理：3步让它马上跑起来

你现在的疑问大概是：这东西装起来会不会很麻烦？答案是不会。input-overlay 是标准的 OBS 前端插件，Windows 和 Linux（64位）都能用，整个流程拆开就三步。

第一步，拿到插件。去项目仓库下载最新版压缩包，解压后把文件放进 OBS 的插件目录。Windows 放C:\Program Files\obs-studio\obs-plugins\64bit\，Linux 放~/.config/obs-studio/plugins/。如果你是想自己编译，也可以用git clone把仓库克隆到本地，仓库地址是https://gitcode.com/gh_mirrors/in/input-overlay，不过对大多数用户来说，直接下载现成压缩包就够了。

第二步，验证安装。重启 OBS，在"来源"面板里点加号。如果你能看到"输入叠加"这个选项，插件就装好了。

第三步，配好一个源。新建"输入叠加"源，此时它会要求你选两样东西：

• 贴图文件：就是那张按键素材图，对应预设目录里的.png
• 配置文件：记录每个按键该在什么位置、对应哪个键位，对应预设目录里的.json

以键盘为例，选presets/wasd/wasd.json加同目录的wasd.png，再把源拖到屏幕角落。现在按下 WASD，画面上对应按键就会高亮。整个过程不到5分钟，效果立竿见影。

装好后你可能会好奇：插件为什么要把"按键长什么样"和"按键怎么摆"拆成两个文件？这就引出了它的核心机制。

拆开看看：它其实是一个"贴图集＋藏宝图"的组合

简单来说，input-overlay 的渲染原理像极了老游戏的做法：把几百个按键画在一张大图上（这张图叫贴图集），再用一个配置文件告诉它"每个键在这张图的哪个位置"。你可以把贴图集想象成一张大地图，把.json配置想象成上面的藏宝标注——哪个坐标藏着一枚 A 键、哪个坐标画着方向键，全靠它来定位。

这种设计的妙处在于：换皮肤只需换贴图，逻辑完全不动。你嫌默认样式丑，重新画一张大图，改一行配置指向它，整个皮肤就换掉了。仓库里的presets/目录就是这种思路的最好证明——那里堆着 30 多套现成预设，从 QWERTY 键盘、Xbox 手柄到 NES 复古手柄一应俱全，全部开箱即用。

插件捕获输入的路径也不复杂：键盘鼠标走libuiohook（跨平台的全局钩子），手柄走 SDL/原生接口，捕获到的按键事件再喂给渲染模块，最终在 OBS 的画布上画出来。整个链路是"捕获→映射→渲染"，每一步都有对应源码可查，想深入研究的读者可以看src/hook/和src/sources/这两个目录。

从零搭一套自己的直播配置：一个完整实战案例

现在我们来把零散知识点串成一条线，跟着做一遍你就能独立上手。假设你是一个 FPS 主播，既用键盘又用 DualSense 手柄，还想顺手显示鼠标轨迹。

第一步，把三个源都加上。在"来源"面板依次新建三个"输入叠加"源，分别指向：

第二步，各就各位。键盘放在屏幕左下角，鼠标放右下角，手柄放右上角。用 OBS 的变换工具拖到合适大小，注意别挡住小地图和血条。

第三步，微调手柄参数。双击手柄源，你会看到"摇杆盲区"这类设置。盲区值调大一点，可以避免手柄摇杆轻微漂移导致画面上摇杆指示乱晃——这点对观感影响很大。

第四步，绑定测试。进入 OBS 预览模式，依次按下键盘、手柄、鼠标的各个按键，确认每个按键都高亮在正确位置。个别键位对不上时，多半是配置与你的键盘布局不匹配，换个预设再试。

到这里，一套"键盘＋手柄＋鼠标"三件套配置就完成了。你会发现它比预想中简单——因为 90% 的脏活累活，现成预设都替你干完了。

我踩过的坑，希望你绕开：5个常见误区

以下几件事都是新手最容易栽跟头的地方，我一个个说清楚，每个都附上解法。

误区一：装完插件却找不到来源选项。十有八九是文件放错了目录，或者 OBS 与插件版本不兼容。解法：核对插件目录路径，确认你下载的是对应系统架构的版本，然后彻底重启 OBS——注意是重启进程，不是关掉再打开窗口。

误区二：按键显示对不上，按 W 亮的却是别的键。这是配置文件和你键盘布局不匹配导致的。解法：换成与键盘布局一致的预设。仓库里连 QWERTZ（德语）、AZERTY（法语）布局都有专门目录，搜qwertz_full_size_german/和zqsd-azerty-minimal/就能找到。

误区三：显示有延迟，手感卡顿。通常不是插件慢，而是同时开太多输入源拖累了性能。解法：在插件设置里适当降低刷新率，并只保留真正需要显示的按键区域——比如只显示 WASD 和空格，别把整个键盘都亮出来。

误区四：中文界面没生效。插件内置 9 种语言文件，都在data/locale/目录下，其中就包括zh-CN.ini。解法：确保语言文件编码是 UTF-8，且版本与插件匹配，然后重启 OBS。个别老版本可能只有部分汉化，属正常现象。

误区五：手柄死活识别不出来。常见于多手柄同时连接时。解法：在插件设置里切换手柄读取方式——Windows 上优先用 XInput，不行就换 DInput；Linux 上用/dev/input/js兼容性最好，多手柄则改用/dev/by-id以便区分设备。

玩腻了默认样式？这里还有几扇门可以推开

如果你觉得基础用法还不够过瘾，input-overlay 还藏了不少进阶玩法。

自定义皮肤并不需要你会写代码。仓库里的docs/cct/是一个网页版的配置工具，打开index.html就能可视化地拖拽按键位置、定义按键行为，最后导出你自己的.json。配合docs/converter/还能把旧版的.ini配置转成新格式。贴图嘛，用 Photoshop 或 GIMP 照着原图尺寸画一张新的就行。

"输入历史"值得一试。插件除了叠加显示，还内置了一个输入历史源，能像弹幕一样把最近的按键串成一排显示，非常适合速通直播和教学场景。presets/input-history-windows/里甚至有人做了纯 HTML 版本，配合 OBS 浏览器源使用，还能自定义 CSS 改样式。

它甚至能把按键数据"发出去"。插件内置了 WebSocket 服务器，开启后任何设备都能实时收到按键事件流。data/example.html就是个现成的示例页面，你可以基于它写自己的可视化方案——有人就靠这个做出了网页端的按键回放。

多设备联动也是加分项。团队开黑时，可以让两台电脑的 input-overlay 通过远程连接互通，一台显示"这台电脑"的输入，另一台显示队友的按键。设置都在"远程连接"选项里，端口默认即可。

这些玩法背后都对应着仓库里具体的目录和源码，读到这里你已经具备了自己探索的能力。

现在，轮到你的直播画面了

回到开头那个场景：观众问"刚才怎么按的"。装好 input-overlay 之后，你不用再费口舌，画面里每个高亮按键就是最好的回答。你的操作本身，成了直播的一部分。

按这个清单收尾，今天就能全部跑通：

• 下载插件并放入 OBS 插件目录，重启验证"输入叠加"来源
• 从presets/选一套适合自己设备的预设，配好贴图和配置
• 调好位置大小、手柄摇杆盲区，逐个按键测试
• 试玩一下输入历史、自定义皮肤和 WebSocket 转发
• 把踩坑经验记下来，分享给同样在折腾的朋友

下次开播，当画面角落里那排按键跟着你的操作跳动起来，你会觉得这个插件的价值，远超它的安装成本。那些被你按下的每一帧操作，从此都不再是无痕迹的瞬间。

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