如何用 input-overlay 让你的直播更专业：3分钟快速上手教程 🚀
项目地址: https://gitcode.com/gh_mirrors/in/input-overlay 什么是 input-overlay？
input-overlay 是一款免费开源的直播输入显示工具，能实时捕捉并展示键盘、鼠标和游戏手柄操作。无论是游戏直播还是软件教学，它都能让观众清晰看到你的每一步操作，让直播互动性提升300%！该项目完全开源，托管在 GitHub 上，支持 Windows 和 Linux 系统，兼容 OBS Studio 等主流直播软件。
为什么选择 input-overlay？
✅ 轻量高效：占用资源少，不影响游戏性能
✅ 高度自定义：内置20+预设布局，支持个性化调整
✅ 多设备支持：键盘、鼠标、游戏手柄全兼容
✅ 免费开源：无广告无付费功能，社区持续更新
图1：xbox-controller 预设布局展示，清晰显示手柄按键状态
快速开始：3步安装配置指南
1️⃣ 环境准备
确保你的系统满足以下要求：
- 操作系统：Windows 10/11 或 Linux (Ubuntu 20.04+)
- 直播软件：OBS Studio 27.0+
- 依赖工具：Git、CMake、C++ 编译器
2️⃣ 一键安装步骤
# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/in/input-overlay.git
cd input-overlay
# 编译安装
mkdir build && cd build
cmake ..
make -j4 # 多线程编译
sudo make install # Linux 系统需管理员权限
3️⃣ OBS 配置教程
- 打开 OBS Studio，添加「窗口捕获」源
- 选择
input-overlay窗口，调整大小和位置 - 启动 input-overlay 客户端：
./input-overlay # Linux input-overlay.exe # Windows
图2：在 OBS 中配置 input-overlay 窗口捕获的示意图
高级玩法：布局自定义与最佳实践
内置预设布局推荐
项目提供丰富的预设文件，存放在 presets/ 目录下，涵盖多种设备类型：
| 设备类型 | 推荐预设路径 | 适用场景 |
|---|---|---|
| 键盘 | presets/wasd/ | FPS 游戏（WASD 移动） |
| 游戏手柄 | presets/dualsense/ | PS5 手柄直播 |
| 街机摇杆 | presets/arcade-stick/ | 格斗游戏直播 |
| 鼠标 | presets/mouse/ | 射击游戏准星展示 |
图3：qwerty-pixel-with-keypad 预设的键盘鼠标组合布局
性能优化技巧
- 降低透明度：在 data/overlay_render/config.js 中调整
opacity参数 - 关闭无用元素：编辑布局 JSON 文件，移除不需要显示的按键
- 使用硬件加速：确保 OBS 启用 GPU 渲染
常见问题解决
Q：为什么按键显示延迟？
A：检查网络连接，或修改 client/src/network_helper.hpp 中的超时设置
Q：如何添加自定义图片？
A：替换预设目录下的 PNG 文件，确保尺寸与 JSON 配置中的 width/height 匹配
Q：Linux 系统无法捕获键盘输入？
A：安装依赖 sudo apt install libuiohook-dev，重新编译项目
结语：让你的直播更具吸引力
input-overlay 不仅是一款工具，更是提升直播质量的得力助手。通过实时展示操作，观众能更沉浸地理解你的游戏策略或教学内容。立即尝试 官方预设库，开启专业直播之旅吧！
如果觉得项目有用，欢迎在 GitHub 给作者点 Star 🌟，或参与 源码贡献！
提示：更多高级功能可参考 docs/ 目录下的官方文档，包含 WebSocket 转发、自定义 CSS 等进阶教程。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
