OBS远程控制终极指南：WebSocket插件完整配置与快速上手

想要实现OBS Studio的远程控制吗？obs-websocket插件为你提供了完美的解决方案！这个强大的WebSocket API插件让你能够通过手机、平板或任何第三方应用程序远程操控OBS，彻底解放你的双手。🚀

什么是OBS WebSocket插件？

obs-websocket 是一个为OBS Studio设计的WebSocket API插件，它通过标准的WebSocket协议为开发者提供了丰富的远程控制功能。从OBS Studio 28.0.0版本开始，这个插件已经内置在OBS中，无需额外下载安装！

🔧 快速安装与配置

自动安装（推荐）

如果你使用的是OBS Studio 28.0.0及以上版本，obs-websocket已经内置在软件中，无需任何额外操作！

手动安装步骤

对于OBS Studio 28.0.0以下版本的用户：

1. 从项目发布页面下载对应平台的二进制文件
2. 将文件解压到OBS的插件目录
3. 重启OBS Studio即可

⚙️ 安全配置要点

强烈建议为obs-websocket设置密码保护，防止未经授权的访问控制。首次加载插件时，系统会自动为你生成一个密码。

密码设置方法

1. 打开OBS的"工具"菜单
2. 选择"obs-websocket设置"对话框
3. 在这里你可以启用或禁用身份验证，并设置自定义密码

💡 专业提示：你还可以使用命令行参数来覆盖配置值：

• --websocket_port（端口号）
• --websocket_password（密码）
• --websocket_debug（调试标志）
• --websocket_ipv4_only（仅IPv4标志）

🎯 实用场景与应用

手机平板远程控制

在同一个局域网内，使用手机或平板远程控制OBS，轻松切换场景、调整音效。

自动场景切换

基于当前场景自动更换流媒体覆盖图形，实现智能化的直播效果。

第三方程序集成

通过脚趾板、宏命令等第三方程序实现自动化场景切换，让你的直播更加专业。

📱 推荐客户端软件

• Macro Deck - 功能强大的宏控制软件
• Touch Portal - 专业的触摸控制界面
• Twitchat - 专为Twitch设计的控制工具
• OBS-web - 基于Web的远程控制界面

🔌 开发者资源

如果你是开发者，这里有一些现成的客户端库可以使用：

• Python：simpleobsws、obsws-python
• Rust：obws
• JavaScript：obs-websocket-js
• Go：goobs

🌐 连接配置详解

默认情况下，obs-websocket服务器运行在端口4455上，你可以在设置对话框中修改这个端口号。

详细的协议文档可以在PROTOCOL.md中找到，包含了完整的API说明和示例。

💡 核心功能模块

项目的主要代码结构位于src/目录下，包含：

• WebSocket服务器：src/websocketserver/
• 事件处理器：src/eventhandler/
• 请求处理器：src/requesthandler/

🚀 开始使用

现在你已经了解了obs-websocket的基本功能和配置方法，是时候开始你的远程控制之旅了！无论你是普通用户想要更便捷地控制OBS，还是开发者想要集成OBS功能，这个插件都能满足你的需求。

记住，安全第一！务必设置强密码保护你的obs-websocket连接。🎉