OBS Studio

OBS Studio 集成通过 OBS 内置的 WebSocket 服务器（obs-websocket 5）将 Macro Deck 连接到 OBS。连接后，按键几乎可以控制直播期间在 OBS 中所做的一切，OBS 也会报告每次变化，因此面板始终显示当前状态。

可以做什么

• 切换节目场景、工作室模式下的预览场景、配置文件或场景集合。
• 开始、停止或切换推流、录制、回放缓存和虚拟摄像头，保存回放、暂停录制、分割录制文件或添加章节标记。
• 在场景中显示或隐藏来源，启用或禁用滤镜，将输入静音或以百分比或 dB 更改其音量。
• 更改来源的某项设置，例如文本来源的文字、图像或媒体来源的文件，或浏览器来源的 URL。
• 按名称启动和停止任意 OBS 输出，包括插件添加的输出。

一些示例设置：

• 一个 马上回来 按键，切换到 BRB 场景并将麦克风静音。
• 一个 录制 按键，切换录制并显示 OBS 正在录制、已暂停还是已停止。
• 一个绑定到音乐输入的 obs_<input>_volume 变量的滑块，移动滑块即可更改 OBS 中的音量。
• 一个在 OBS 报告 推流已开始 时运行的流程，向你发送通知。

运行方式

Macro Deck 会监听 OBS 发送的事件，因此当前场景、静音状态和滤镜状态等变量会在 OBS 中更改后的一瞬间更新。切换按键在其状态处于活动时会亮起，即使是在 OBS 中更改的也一样。帧率、CPU 使用率、码率和丢帧数等统计信息每一到两秒读取一次。

除了固定变量外，变量选择器还会列出所连接 OBS 的每个输入、场景、场景项和滤镜，以及其音量、静音状态、可见性或启用状态。触发器可以响应场景变化、录制和推流变化、保存的回放和截图、输入变为活动，以及你自己的 OBS 脚本广播的自定义事件。

可以添加多个配置，例如一个用于推流电脑，一个用于游戏电脑。每个配置都有自己的一组变量，每个动作都有一个 配置 字段，用于选择要控制的 OBS。当 OBS 关闭或网络中断时，Macro Deck 会持续尝试重新连接，并触发 已断开连接 和 已连接 触发器。