Streamlabs Desktop
Macro Deck 自带在 Streamlabs Desktop 中切换场景，控制推流、录制和音频来源。
“连接 Streamlabs Desktop”对话框，包含 API 令牌字段
- 切换场景，并在工作室模式下进行过渡
- 开始和停止推流、录制和回放缓存
- 静音音频来源并设置其音量
- 在场景中显示、隐藏、翻转、旋转或适配来源
- 推流与录制状态及时长的实时变量
Streamlabs Desktop 集成通过远程控制 API 将 Macro Deck 连接到 Streamlabs Desktop（原 Streamlabs OBS）。使用 Streamlabs Desktop 显示的 API 令牌进行连接，之后按键就可以控制场景、来源、音频和输出。
可以做什么
- 切换当前场景，开启或关闭工作室模式，并将工作室模式下的预览过渡到直播输出。
- 开始、停止或切换推流、录制和回放缓存，并保存回放。
- 在场景中显示、隐藏或切换来源。
- 将音频来源静音、取消静音或切换静音状态，设置其音量，或按步长增大和减小音量。
- 对来源执行变换：重置变换、水平或垂直翻转、在屏幕上适配、拉伸或居中，或者旋转。
- 将音频来源的音量或静音状态，或者来源的可见性，读取到变量中。
一些示例设置：
- 一个 马上回来 按键，切换到 BRB 场景并将麦克风静音。
- 一个 剪辑 按键，保存回放缓存。
- 一个 开始直播 按键，切换推流并显示是否正在直播。
- 一个在 推流已开始 时运行的流程，显示摄像头来源。
运行方式
Macro Deck 会监听 Streamlabs Desktop 发送的事件，因此场景、推流、录制、回放缓存和工作室模式的变量会跟随你在 Streamlabs Desktop 中的操作更新。当场景变化，推流或录制开始、停止或状态改变，回放缓存启动或停止，工作室模式变化，以及来源被静音、显示或隐藏时，都会触发触发器。
该集成只有一个配置。默认情况下，它连接到同一台电脑上的 Streamlabs Desktop。在设置中的 高级配置 下，可以输入另一台电脑的地址。Streamlabs Desktop 关闭时，Macro Deck 会持续尝试重新连接。如果在 Streamlabs Desktop 中生成了新令牌，集成页面会显示 Streamlabs Desktop 拒绝了 API 令牌，此时请使用新令牌重新运行设置。
准备工作
- Windows、macOS 或 Linux 上的 Macro Deck 3
- 在这台电脑或网络中另一台电脑上运行的 Streamlabs Desktop
- 已在 Streamlabs Desktop 中开启远程控制，以及其 API 令牌
设置步骤
第 1 步: 在 Streamlabs Desktop 中找到 API 令牌
在 Streamlabs Desktop 中打开 Settings，然后打开 Remote Control。在较新版本中，它位于 Mobile 的 Third Party Connections 下，并且需要在那里开启。点击二维码并选择 show details 以显示 API 令牌，然后复制它。
第 2 步: 在 Macro Deck 中打开 Streamlabs Desktop
在 Macro Deck 中，点击侧边栏中的 集成，然后点击 Streamlabs Desktop。在 概览 选项卡的 配置 部分中点击 设置。打开右上角的开关也会打开同一个对话框，完成设置后集成即会启用。
第 3 步: 粘贴 API 令牌
在 连接 Streamlabs Desktop 对话框中，将令牌粘贴到 API 令牌 中。
如果 Streamlabs Desktop 运行在另一台电脑上，请开启 高级配置，并将其 IP 地址填为 地址。除非确定端口不是
59650，否则请将 端口 留空。点击 继续。Macro Deck 会先测试连接，再保存。第 4 步: 为按键添加 Streamlabs Desktop 动作
在 面板 页面上，点击要使用的按键。面板必须处于解锁状态：右上角的按钮显示为 锁定 时，面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作，在 添加动作 对话框左侧选择 Streamlabs Desktop，然后选择一个动作，例如 设置场景。选择 场景，然后点击 保存。
第 5 步: 按下按键
在手机、平板或 Web 客户端上按下该按键。Streamlabs Desktop 会切换到该场景。如果没有反应，请确认 Streamlabs Desktop 正在运行，并且在 集成 下的 Streamlabs Desktop 页面上，该配置显示为 已连接。
动作19
可以放在按键上，也可以在流程中运行。
- 设置场景
- 切换当前场景。
- 开始推流
- 如果尚未直播，则开始推流。
- 停止推流
- 如果正在直播，则停止推流。
- 切换推流
- 开始或停止推流。
- 开始录制
- 如果尚未录制，则开始录制。
- 停止录制
- 停止当前的录制。
- 切换录制
- 开始或停止录制。
- 启动回放缓存
- 启动回放缓存。
- 停止回放缓存
- 停止回放缓存。
- 切换回放缓存
- 启动或停止回放缓存。
- 保存回放
- 将当前的回放缓存写入磁盘。
- 设置来源可见性
- 在场景中显示、隐藏或切换来源。
- 获取来源可见性
- 将来源是否可见读取到变量中。
- 音频来源静音
- 将音频来源静音、取消静音或切换静音状态。
- 设置音频音量
- 设置、增大或减小音频来源的音量。
- 获取音频来源状态
- 将音频来源的音量或静音状态读取到变量中。
- 场景项动作
- 在场景中重置、翻转、适配、拉伸、居中或旋转来源。
- 切换工作室模式
- 开启或关闭工作室模式。
- 工作室模式过渡
- 将工作室模式下的预览过渡到直播输出。
触发器14
按键或流程可以对这些事件做出响应。
- 场景已更改
- 当前场景发生了变化。可选择仅限某一个场景。
- 推流已开始
- Streamlabs Desktop 已开始推流。
- 推流已停止
- Streamlabs Desktop 已停止推流。
- 推流状态已更改
- 推流状态在离线、正在开始、直播中、正在结束和正在重新连接之间发生了变化。
- 录制已开始
- Streamlabs Desktop 已开始录制。
- 录制已停止
- Streamlabs Desktop 已停止录制。
- 录制状态已更改
- 录制状态在离线、正在开始、正在录制和正在停止之间发生了变化。
- 回放缓存已启动
- 回放缓存已启动。
- 回放缓存已停止
- 回放缓存已停止。
- 工作室模式已更改
- 工作室模式已开启或关闭。
- 来源静音状态已更改
- 某个音频来源被静音或取消静音。
- 来源可见性已更改
- 某个来源在场景中被显示或隐藏。
- 已连接
- Macro Deck 已连接到 Streamlabs Desktop。
- 已断开连接
- 与 Streamlabs Desktop 的连接已中断。
变量7
在按键和组件上显示这些值，或在条件中使用它们。
streamlabs_is_connected- Macro Deck 是否已连接到 Streamlabs Desktop。
streamlabs_current_scene- 当前场景。
streamlabs_scene_count- 场景的数量。
streamlabs_is_streaming,streamlabs_streaming_status,streamlabs_streaming_seconds- 是否正在直播、推流状态以及推流已进行多久。
streamlabs_is_recording,streamlabs_recording_status,streamlabs_recording_seconds- 是否正在录制、录制状态以及录制已进行多久。
streamlabs_replay_buffer_active,streamlabs_replay_buffer_status- 回放缓存是否正在运行及其状态。
streamlabs_studio_mode_active- 工作室模式是否开启。
常见问题解答
Streamlabs Desktop 运行在另一台电脑上时能用吗？
能。设置时开启 高级配置，并将那台电脑的 IP 地址填为 地址。端口 59650 必须能够通过其防火墙访问。
Streamlabs Desktop 拒绝了 API 令牌，该怎么办？
令牌已在 Streamlabs Desktop 中重新生成，或者远程控制已被关闭。请开启远程控制，显示当前令牌，并用它重新运行设置。
Streamlabs Desktop 关闭时会怎样？
Macro Deck 会持续尝试重新连接，Streamlabs Desktop 一运行就会再次连接。在此之前，动作会失败并显示 Streamlabs Desktop 未连接。
音量是以分贝为单位的吗？
不是。设置音频音量 使用 Streamlabs Desktop 显示的推子位置，以百分比表示，而不是分贝值。
API 令牌存储在哪里？
Macro Deck 将令牌加密存储在运行 Macro Deck 的电脑上，并且只用它来连接 Streamlabs Desktop。
“直播”分类中的更多集成
OBS Studio
Macro Deck 自带切换场景，控制推流、录制和音频，并对 OBS Studio 中发生的事情做出响应。
Meld Studio
Macro Deck 自带在 Meld Studio 中切换和暂存场景，控制图层、效果和音轨，并开始直播。
Streamer.bot
Macro Deck 自带运行 Streamer.bot 动作、发送聊天消息，并对 Streamer.bot 报告的每个事件做出响应。
Twitch
Macro Deck 自带显示 Twitch 聊天和直播数据，进行管理、发起投票和播放广告，并对关注、订阅和突袭做出响应。
YouTube
Macro Deck 自带显示 YouTube 直播聊天和直播统计，更改标题和标签，并对 Super Chat 和会员做出响应。