Streamer.bot
Macro Deck 自带运行 Streamer.bot 动作、发送聊天消息，并对 Streamer.bot 报告的每个事件做出响应。
“连接 Streamer.bot”对话框，包含地址、端口、端点和密码
- 运行任意 Streamer.bot 动作，可附带参数
- 触发自定义代码触发器
- 向 Twitch、YouTube、Trovo 或 Kick 发送聊天消息
- 响应 Streamer.bot 报告的任何事件
- 将 Streamer.bot 全局变量读取到 Macro Deck 中
Streamer.bot 集成将 Macro Deck 连接到 Streamer.bot 的 WebSocket 服务器。按键可以启动在 Streamer.bot 中构建的动作，而 Streamer.bot 报告的一切（聊天消息、关注、订阅、突袭、频道积分兑换、计时器和自定义代码事件）都可以在 Macro Deck 中启动流程。
可以做什么
- 运行 Streamer.bot 动作。从动作列表中选择，并可传入参数，动作以
%key%的形式读取参数。 - 触发自定义代码触发器，同样可以传入参数。
- 通过 Streamer.bot 以主播账户或机器人账户向 Twitch、YouTube、Trovo 或 Kick 发送聊天消息。消息中可以包含 Macro Deck 变量和事件值。
- 将 Streamer.bot 全局变量（持久化的或仅限当前会话的）读取到 Macro Deck 变量中。
- 使用 Streamer.bot 事件 触发器响应任意 Streamer.bot 事件。选择一个来源（例如 Twitch）和一个事件来缩小范围，或者两者都留空以响应所有事件。流程会收到用户、消息以及 JSON 格式的原始事件数据。
一些示例设置：
- 一个 场景：游戏 按键，运行 Streamer.bot 动作并将场景名称作为参数传入。
- 一个 喝水提醒 按键，包含两个 发送聊天消息 动作，在 Twitch 和 YouTube 上发布相同的提醒。
- 一个在 Streamer.bot 中的 Twitch 关注事件发生时运行的流程，在 Macro Deck 中显示通知。
- 一个从 Streamer.bot 全局变量读取计数器并将其显示为标签的按键。
运行方式
Macro Deck 会与 Streamer.bot 保持连接，并实时接收其事件。变量会显示连接是否正常、Streamer.bot 版本、实例名称，以及主播的名称和平台。当 Streamer.bot 关闭或其 WebSocket 服务器停止时，Macro Deck 会持续尝试重新连接，已连接 和 已断开连接 触发器可让流程做出响应。该集成只有一个配置。
准备工作
- Windows、macOS 或 Linux 上的 Macro Deck 3
- 在这台电脑或网络中另一台电脑上运行的 Streamer.bot
- 已在 Streamer.bot 的 Servers/Clients > WebSocket Server 中启动 WebSocket 服务器
设置步骤
第 1 步: 在 Streamer.bot 中启动 WebSocket 服务器
在 Streamer.bot 中打开 Servers/Clients > WebSocket Server，确认服务器已启动。记下地址、端口和端点；如果开启了身份验证，还要记下密码。
第 2 步: 在 Macro Deck 中打开 Streamer.bot
在 Macro Deck 中，点击侧边栏中的 集成，然后点击 Streamer.bot。在 概览 选项卡的 配置 部分中点击 设置。打开右上角的开关也会打开同一个对话框，完成设置后集成即会启用。
第 3 步: 输入连接信息
在 连接 Streamer.bot 对话框中填写：
- 地址：Streamer.bot 在同一台电脑上运行时为
127.0.0.1，否则为其 IP 地址。 - 端口：WebSocket 服务器端口，默认为
8080。 - 端点：服务器监听的路径，默认为
/。 - 密码：仅在 Streamer.bot 中开启了身份验证时填写。
点击 继续。Macro Deck 会先测试连接，再保存。
- 地址：Streamer.bot 在同一台电脑上运行时为
第 4 步: 为按键添加 Streamer.bot 动作
在 面板 页面上，点击要使用的按键。面板必须处于解锁状态：右上角的按钮显示为 锁定 时，面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作，在 添加动作 对话框左侧选择 Streamer.bot，然后选择 运行动作。在 动作 下选择 Streamer.bot 动作，如有需要，添加 参数。然后点击 保存。
第 5 步: 按下按键
在手机、平板或 Web 客户端上按下该按键。Streamer.bot 会运行该动作。如果没有反应，请确认 Streamer.bot 中的 WebSocket 服务器已启动，并且在 集成 下的 Streamer.bot 页面上，该配置显示为 已连接。
动作4
可以放在按键上，也可以在流程中运行。
- 运行动作
- 运行一个 Streamer.bot 动作，可附带参数。
- 执行代码触发器
- 触发一个 Streamer.bot 自定义代码触发器，可附带参数。
- 发送聊天消息
- 通过 Streamer.bot 向 Twitch、YouTube、Trovo 或 Kick 发送聊天消息。
- 获取全局变量
- 将 Streamer.bot 全局变量读取到 Macro Deck 变量中。
触发器3
按键或流程可以对这些事件做出响应。
- Streamer.bot 事件
- Streamer.bot 报告的任何内容，例如聊天消息、关注、订阅、突袭、兑换、计时器和自定义代码事件。可按来源和事件缩小范围。
- 已连接
- Macro Deck 已连接到 Streamer.bot。
- 已断开连接
- 与 Streamer.bot 的连接已中断。
变量5
在按键和组件上显示这些值，或在条件中使用它们。
streamerbot_is_connected- Macro Deck 是否已连接到 Streamer.bot。
streamerbot_version- Streamer.bot 的版本。
streamerbot_instance_name- Streamer.bot 实例的名称。
streamerbot_broadcaster_name- Streamer.bot 中的主播账户。
streamerbot_broadcaster_platform- 主播账户所在的平台。
常见问题解答
Streamer.bot 运行在另一台电脑上时能用吗？
能。将那台电脑的 IP 地址填为 地址。在 Streamer.bot 中，WebSocket 服务器必须监听在另一台电脑能访问的地址上，并且端口必须在其防火墙中放行。
需要密码吗？
只有在 Streamer.bot 中为 WebSocket 服务器开启了身份验证时才需要。Macro Deck 将密码加密存储在运行 Macro Deck 的电脑上。
如何向 Streamer.bot 动作传递值？
在 运行动作 或 执行代码触发器 的 参数 下添加。每个键在 Streamer.bot 中都可以用 %key% 访问。
Streamer.bot 关闭时会怎样？
Macro Deck 会持续尝试重新连接，WebSocket 服务器恢复后即会再次连接。在此之前，动作会失败并显示 Streamer.bot 未连接。
“获取全局变量”为什么提示变量不存在？
请检查名称，以及该变量在 Streamer.bot 中是否为持久化变量。如需读取只在当前会话中存在的变量，请在动作中关闭 持久化。
“直播”分类中的更多集成
OBS Studio
Macro Deck 自带切换场景，控制推流、录制和音频，并对 OBS Studio 中发生的事情做出响应。
Meld Studio
Macro Deck 自带在 Meld Studio 中切换和暂存场景，控制图层、效果和音轨，并开始直播。
Streamlabs Desktop
Macro Deck 自带在 Streamlabs Desktop 中切换场景，控制推流、录制和音频来源。
Twitch
Macro Deck 自带显示 Twitch 聊天和直播数据，进行管理、发起投票和播放广告，并对关注、订阅和突袭做出响应。
YouTube
Macro Deck 自带显示 YouTube 直播聊天和直播统计，更改标题和标签，并对 Super Chat 和会员做出响应。