Twitch
Macro Deck 自带显示 Twitch 聊天和直播数据,进行管理、发起投票和播放广告,并对关注、订阅和突袭做出响应。
一个 Twitch 聊天组件和显示观众、聊天者与关注者数量的 Twitch 直播数据组件
- Twitch 聊天和 Twitch 直播数据组件
- 设置标题和分类、播放广告、发起突袭和创建剪辑
- 通过按键发起投票、预测、推荐和切换聊天模式
- 关注、订阅、打赏、突袭和兑换的触发器
- 可连接多个 Twitch 账户
Twitch 集成将一个或多个 Twitch 账户连接到 Macro Deck。使用一个简短的代码在 Twitch 上登录后,Macro Deck 就会实时接收频道的事件,并能以该账户的身份在频道上执行操作。
可以做什么
- 更改直播标题、分类和标签,发送聊天消息和公告,以及发送推荐。
- 插播广告、推迟下一次广告、发起或取消突袭、创建剪辑或直播标记。
- 开始和结束投票与预测,并将频道积分兑换标记为已完成或已退还。
- 管理:封禁或禁言用户、解封、删除消息、清空聊天,以及开启或关闭仅表情、仅关注者、慢速、仅订阅者或独特聊天模式。
- 在 Twitch 聊天 组件中显示带表情和徽章的聊天,并在其中进行管理。
- 在 Twitch 直播数据 组件中显示直播状态、观众、聊天用户、关注者和订阅者、标题、分类和已直播时长。
一些示例设置:
- 一个 即将开始 按键,设置标题和分类并发送公告。
- 一个 插播广告 按键,播放 90 秒的广告。
- 一个 剪辑 按键,创建剪辑并将其编辑 URL 写入变量。
- 一个针对某个奖励、在 频道积分奖励已兑换 时运行的流程,切换 OBS 场景。
- 一个在 收到突袭 时运行的流程,向突袭者发送推荐。
运行方式
Macro Deck 会为每个已连接的账户订阅 Twitch 事件,因此 新关注者、打赏 Bits 或 收到突袭 等触发器会在片刻内触发。观众数量等直播数值每 30 秒从 Twitch 读取一次。所有数值都以 twitch_<account>_<value> 形式的变量提供,例如 twitch_mychannel_viewer_count,因此可以在自己的组件和条件中使用。
可以连接多个 Twitch 账户。每个动作都有一个 账户 字段,每个触发器都可以限定为某个账户。如果 Twitch 没有授予 Macro Deck 请求的所有权限,集成 会列出将不会触发的事件,并提供重新连接的选项。与 Twitch 的连接中断时,Macro Deck 会自动重新连接。如果某个账户 30 天未在 Macro Deck 中使用,或者你在 Twitch 上撤销了其访问权限,登录就会过期,集成 会要求重新连接该账户。
准备工作
- Windows、macOS 或 Linux 上可访问互联网的 Macro Deck 3
- 一个 Twitch 账户
- “播放广告”需要正在直播的联盟或合作伙伴频道
- 剪辑和直播标记仅在频道直播时可用
设置步骤
第 1 步: 在 Macro Deck 中打开 Twitch
在 Macro Deck 中,点击侧边栏中的 集成,然后点击 Twitch。在 概览 选项卡的 配置 部分中点击 添加配置。打开右上角的开关也会打开同一个对话框,完成设置后集成即会启用。
第 2 步: 在 Twitch 上批准访问
连接 Twitch 账户 对话框会显示一个 设备码。点击 打开 Twitch 并批准:Twitch 会在浏览器中打开,并已填好代码。用要连接的账户登录并批准访问。
如需使用自己注册的 Twitch 应用,请开启 高级配置,并在 自己的客户端 ID(高级) 中输入其客户端 ID。将该字段留空则使用 Macro Deck 自己的应用。
第 3 步: 完成设置
回到 Macro Deck 并点击 继续。Macro Deck 会以你的账户为配置命名,例如 Twitch (mychannel)。对话框显示 设置完成。 后,点击 完成。
第 4 步: 为按键添加 Twitch 动作
在 面板 页面上,点击要使用的按键。面板必须处于解锁状态:右上角的按钮显示为 锁定 时,面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作,在 添加动作 对话框左侧选择 Twitch,然后选择一个动作,例如 发送聊天消息。选择 账户,输入 消息,然后点击 保存。
第 5 步: 按下按键
在手机、平板或 Web 客户端上按下该按键。消息会出现在 Twitch 聊天中。如需在面板上查看聊天,请添加一个 Twitch 聊天 组件。
动作20
可以放在按键上,也可以在流程中运行。
- 设置标题和分类
- 更改直播标题、分类或标签。留空的字段保持不变。
- 发送聊天消息
- 以已连接账户的身份向频道聊天发送消息,可选择作为回复发送。
- 发送公告
- 在聊天中以所选颜色发布一条醒目的公告。
- 发送推荐
- 为另一个频道发送推荐。Twitch 每两分钟只允许一次。
- 清空聊天
- 移除频道聊天中的所有消息。
- 删除聊天消息
- 从聊天中移除单条消息。
- 设置聊天模式
- 开启、关闭或切换仅表情、仅关注者、慢速、仅订阅者或独特聊天模式。
- 播放广告
- 开始一段 30 秒到 3 分钟的广告插播。
- 推迟下一次广告
- 将下一次计划的广告插播推迟五分钟。
- 发起突袭
- 将频道的观众送往另一个频道。
- 取消突袭
- 停止尚未完成的突袭。
- 创建剪辑
- 剪辑直播的最后 30 秒,并可将剪辑的编辑 URL 写入变量。
- 创建直播标记
- 标记直播中的当前位置,以便之后编辑。
- 封禁或禁言用户
- 封禁某位观众,或在指定时长时将其禁言。
- 解封用户
- 解除封禁或禁言。
- 创建投票
- 发起一个包含二到五个选项的投票。
- 结束投票
- 结束当前正在进行的投票。
- 创建预测
- 发起一个包含二到十个结果的频道积分预测。
- 结束预测
- 结算、锁定或取消当前正在进行的预测。
- 处理奖励兑换
- 将频道积分兑换标记为已完成或将其退还(仅适用于由同一 Twitch 应用创建的奖励)。
触发器39
按键或流程可以对这些事件做出响应。
- 直播已上线
- 频道开始直播。
- 直播已下线
- 频道停止直播。
- 频道信息已更新
- 标题、分类、语言或内容标签发生了变化。
- 广告已开始
- 频道开始插播广告。
- 新关注者
- 有人关注了频道。
- 新订阅
- 有人订阅了频道。可选择仅限某一个等级。
- 续订
- 有人在聊天中宣布了续订。
- 赠送订阅
- 有人向频道赠送了订阅。
- 订阅已结束
- 某个频道订阅已到期。
- 打赏 Bits
- 有人在频道中打赏了 Bits。
- 收到突袭
- 另一个频道突袭了此频道。
- 已发出突袭
- 此频道突袭了另一个频道。
- 收到推荐
- 另一个频道为此频道发送了推荐。
- 已发送推荐
- 频道发送了一次推荐。
- 频道积分奖励已兑换
- 某位观众兑换了频道积分奖励。可选择仅限某一个奖励。
- 自动奖励已兑换
- 某位观众使用了 Twitch 内置的频道积分奖励。
- 兑换已处理
- 某个频道积分兑换已被接受或退还。
- 投票已开始
- 频道中开始了一个投票。
- 投票已结束
- 频道中的一个投票已结束。
- 预测已开始
- 频道中开始了一个预测。
- 预测已锁定
- 某个预测已停止接受参与。
- 预测已结束
- 某个预测已结算或取消。
- 热度列车已开始
- 频道中开始了一辆热度列车。
- 热度列车进展
- 频道中的热度列车有了进展。
- 热度列车已结束
- 频道中的热度列车已结束。
- 目标已开始
- 某个创作者目标已开始。
- 目标进展
- 某个创作者目标有了进展。
- 目标已结束
- 某个创作者目标已结束。
- 聊天通知
- 聊天中的订阅、续订、赠送、突袭、公告或慈善通知。可选择仅限某一种类。
- 聊天已清空
- 频道的聊天已被清空。
- 聊天消息已删除
- 某条聊天消息已被删除。
- 聊天模式已更改
- 仅表情、仅关注者、慢速、仅订阅者或独特聊天模式被切换。
- 用户被封禁或禁言
- 某位观众被封禁或禁言。
- 用户已解封
- 某位观众被解封。
- 已添加 VIP
- 某位观众获得了 VIP 身份。
- 已移除 VIP
- 某位观众失去了 VIP 身份。
- Twitch 事件(高级)
- 所有 Twitch 事件,包括 Macro Deck 尚未建模的事件,附带原始数据。
- 已连接
- Macro Deck 已将该账户连接到 Twitch。
- 已断开连接
- 与 Twitch 的连接已中断。
变量10
在按键和组件上显示这些值,或在条件中使用它们。
twitch_<account>_is_connected- 该账户是否已连接到 Twitch。
twitch_<account>_is_live- 频道是否正在直播。
twitch_<account>_stream_title,twitch_<account>_stream_category- 当前的标题和分类。
twitch_<account>_viewer_count,twitch_<account>_uptime_seconds- 观众数以及直播已进行的秒数。
twitch_<account>_follower_count,twitch_<account>_subscriber_count,twitch_<account>_subscriber_points- 频道的关注者、订阅者和订阅者积分总数。
twitch_<account>_chatter_count- 聊天中的所有人,包括你自己和机器人。
twitch_<account>_stream_thumbnail_url- 当前直播缩略图的 URL。
twitch_<account>_display_name,twitch_<account>_login- 账户的显示名称和登录名。
twitch_<account>_emote_only,twitch_<account>_followers_only,twitch_<account>_followers_only_duration,twitch_<account>_slow_mode,twitch_<account>_slow_mode_wait_time,twitch_<account>_subscriber_only,twitch_<account>_unique_chat- 聊天模式:仅表情、仅关注者及其时长(分钟)、慢速模式及其等待时间(秒)、仅订阅者和独特聊天。
twitch_<account>_last_follower,twitch_<account>_last_subscriber,twitch_<account>_last_cheerer,twitch_<account>_last_raider- 最近的关注者、订阅者、打赏者和突袭者。
组件2
从组件选择器中将它们添加到面板。
- Twitch 聊天
- 显示频道中带表情和徽章的聊天。按下它会打开一个更大的聊天窗口,可以在其中删除消息、禁言和封禁。
- Twitch 直播数据
- 以所选样式显示直播状态、观众、聊天用户、关注者和订阅者、标题、分类和已直播时长。
常见问题解答
可以连接多个 Twitch 账户吗?
可以。再次点击 添加配置,然后用另一个账户批准。每个动作都有一个 账户 字段,变量名中也包含账户名称,例如 twitch_mychannel_is_live。
为什么需要重新登录?
Twitch 会在 30 天未使用后,或者在你于 Twitch 上撤销 Macro Deck 的访问权限后结束登录。此时 集成 会显示登录已过期。使用 重新连接 再次批准访问即可。
动作为什么会失败?
许多动作只在特定情况下有效:创建剪辑 和 创建直播标记 需要频道正在直播,播放广告 需要正在直播的联盟或合作伙伴频道,发送推荐 每两分钟只能使用一次。如果 Twitch 没有授予某项权限,请重新连接账户以授予该权限。
为什么无法处理现有奖励的兑换?
Twitch 只允许应用处理由同一应用创建的奖励的兑换。在 Twitch 控制面板中创建的奖励无法通过 API 处理。
谁可以通过聊天组件进行管理?
任何可以使用你的面板的人。如果只想显示聊天,请在组件设置中关闭 允许在聊天对话框中进行管理。
Twitch 令牌存储在哪里?
Macro Deck 将访问令牌和刷新令牌加密存储在运行 Macro Deck 的电脑上。你绝不会在 Macro Deck 中输入 Twitch 密码:访问是在 Twitch 上批准的。
“直播”分类中的更多集成
OBS Studio
Macro Deck 自带切换场景,控制推流、录制和音频,并对 OBS Studio 中发生的事情做出响应。
Meld Studio
Macro Deck 自带在 Meld Studio 中切换和暂存场景,控制图层、效果和音轨,并开始直播。
Streamlabs Desktop
Macro Deck 自带在 Streamlabs Desktop 中切换场景,控制推流、录制和音频来源。
Streamer.bot
Macro Deck 自带运行 Streamer.bot 动作、发送聊天消息,并对 Streamer.bot 报告的每个事件做出响应。
YouTube
Macro Deck 自带显示 YouTube 直播聊天和直播统计,更改标题和标签,并对 Super Chat 和会员做出响应。