企业官网建设流程全解析

Bitfocus Companion 完整指南：把 Stream Deck 变成专业媒体控制面板

【免费下载链接】companionBitfocus Companion enables the Elgato Stream Deck and other controllers to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.项目地址: https://gitcode.com/gh_mirrors/co/companion

Bitfocus Companion 是一个开源媒体控制系统：它把 Stream Deck 或任意物理控制器变成专业控制面板，一个键就能指挥 OBS、摄像机、音频和灯光，不用再在多个软件之间来回奔波。

媒体控制痛点：导播台为什么总差一个"一键切换"

晚上九点的直播现场。导播在 OBS 里切机位，在另一台软件里压音乐，还得管第三块面板的灯光。想"切到 2 号机位、音乐渐弱、舞台灯亮起"，得按顺序点三个不同软件。漏点一下，直播就穿帮了。Bitfocus Companion 就是为这个痛点而生的：它接管物理控制器的按键分配，把一串操作压缩成一个键，还能把各个软件的状态同步回按钮灯光。

⚡ 30秒看懂 Bitfocus Companion 是什么：开源媒体控制面板

一句话定位：把任意按键盒变成专业 shotbox（现场导播台）的开源媒体控制中枢。核心能力：

• 硬件不挑：Stream Deck、Loupedeck、Elgato Key 等物理控制器都能认
• 软件不挑：700+ 连接模块，覆盖 OBS、vMix、QLab、灯光音响设备
• 按钮完全可编程：短按、长按、双击、多步序列，每步都能触发不同操作
• 双向反馈：按钮背光随软件状态变化，一眼看出场景是否就绪
• 分布式部署：一台服务器同时服务多个控制终端

管理界面：左侧功能入口、右侧配置区，按钮配置与连接管理快速切换。

🧩 Bitfocus Companion 内部分层拆解：3 层各管一件事

整个系统是三层结构，每层只干一件事：

硬件接入层，目录companion/lib/Surface/。像个"翻译官"：不管设备的 USB 协议多奇怪，都翻译成统一的"按钮+旋钮+屏幕"语言，上层不用关心硬件细节。设备驱动本身也是模块化的，新机型装个模块就能接。

控制逻辑层，目录companion/lib/Controls/。每个按钮在这里被当作一台小状态机管理：按下、松开、长按、双击，每种手势可以指向不同的动作序列，动作执行器按你定义的顺序逐步跑完操作。

协议交互层，如companion/lib/Service/OscApi.ts。动作要发出去时，这一层把它翻译成 OSC、HTTP 或原始 TCP/UDP 发出去。每种协议各有一个独立服务，但内部说的是同一种"话"，控制逻辑完全不用关心具体协议。

🔍 关键能力深潜：按钮序列、状态反馈与分布式控制怎么实现

按钮是一串"动作序列"，不是单次触发

用在哪：直播时一个键要完成"音频淡出→切场景→上字幕"，没人想连按三下。怎么做：按钮可以挂多个"步骤"，每种手势指向不同的步骤组合，按顺序执行。你拿到的收益：导播只记键位、不记顺序，复杂操作压缩成一次按键。

按钮配置界面：为每个按键绑定动作序列，支持多页面与快捷键。

按钮灯是一块"状态显示屏"

用在哪：舞台上要一眼看出哪台摄像机是活动机位，看笔记本太慢。怎么做：变量系统持续从已连接软件取状态，表达式引擎做"如果 A 就"的判断，条件成立时按钮背光或图标跟着变。你拿到的收益：不用看屏幕，控制器面板本身成了状态板。

一台服务器带多个控制端

用在哪：大型活动导播台、灯光台、音响室各要一套控制，买多台设备太贵。怎么做：Companion 提供 Satellite 通道（TCP 和 WebSocket），远端客户端或浏览器页面可以在任何终端上渲染同一套按键布局，操作再通过网络回传给中心服务器。你拿到的收益：硬件复用、布局一致，新增终端只改一条网络配置。

浏览器控制面板：网页打开同款按键布局，无硬件也能远程操作。

🖥️ 2 个真实场景的按钮配置步骤

直播导播：从 0 到一键切换

第一步：Stream Deck 接上电脑，启动 Companion，自动识别设备。 第二步：Web 界面点"添加连接"，选 OBS。 第三步：给按钮绑定"切场景+压音乐"，把活动状态设成红灯。 完成，按一下就出效果。

会议室 AV：无头服务器 + 平板

第一步：Docker 无头方式在服务器上跑 Companion，挂载配置目录。 第二步：平板浏览器打开服务器地址，看到同款控制面板。 第三步：把"开始投屏"绑到按钮上，全会议室的人都能一键发起。

📦 生态与扩展：700+ 连接模块如何运转

模块系统像个 App Store，入口是companion/lib/Instance/ModuleStore.ts，负责安装、更新、卸载。每个模块自带清单，声明自己需要哪个 API 版本和哪些依赖，系统加载时校验兼容性，不匹配就拒装，不会拖垮整个程序。700 多个连接模块从 OBS、vMix 到灯光音响全覆盖；设备驱动从 4.3 版本起也模块化，新机型装个模块就能加进来，社区模块还在持续更新。

模块管理界面：已装连接模块与版本一目了然，更新统一处理。

✅ 上手与选型：3 步跑起 Bitfocus Companion 的部署方式

适合谁：做直播、会议室 AV、剧院演出，需要用物理按钮同时操作多套软件的人。

• 桌面端：官网下载安装包（分稳定版和 beta），装上直接跑
• 服务器端：用 Docker 镜像无头运行，记得挂载卷持久化配置
• 参与开发：克隆仓库 https://gitcode.com/gh_mirrors/co/companion ，然后运行yarn dev启动本地开发

⚠️ 三个常见坑：

• Linux 下 USB 控制器需要装 udev 规则，程序会提示你操作
• Docker 不支持 USB 直通，物理 Stream Deck 要本地跑或用卫星方案
• 生产环境选稳定版，beta 功能多但可能有 bug

Companion 把"按键"变成了可编程的资源：硬件层管接入，逻辑层管序列，协议层管送达。想动手试试？先接上控制器，挑一套你最常用的软件，绑定第一个按钮序列——按下去的那一刻，你就明白专业团队为什么离不开它了。

【免费下载链接】companionBitfocus Companion enables the Elgato Stream Deck and other controllers to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.项目地址: https://gitcode.com/gh_mirrors/co/companion