硬件整蛊软件怎么用：从弹幕到硬件的全链路
这一页按「接入 → 匹配 → 控制 → 输出 → 玩法」的顺序，把荔枝硬件整蛊的每一项能力讲清楚，
方便你对照自己直播间的玩法挑选配置方式。
提示：各平台的弹幕数据由「弹幕助手」抓取并提供给主程序，
主程序只负责规则匹配与硬件控制。
七种控制模式，直接决定玩法
控制模式决定了「观众的互动如何换算成动作」。在弹幕控制里为每个平台选择一种模式，配合数据来源即可开播；弹幕数据由「弹幕助手」抓取提供。
报价排队模式
观众出价进入队列，按顺序执行硬件动作。适合拍卖式、竞价式互动，队列顺序清晰可控。
累计积分模式
礼物转化为积分累计，达到设定阈值后触发对应动作，适合养成型、长期互动玩法。
抓钢珠
弹幕或礼物触发抓取机构，观众远程“抓一把”，配合音效与播报更具节目效果。
弹珠机
触发发射弹珠并联动计分，适合多人比拼与连击玩法。
娃娃机
礼物控制爪机动作，观众远程抓娃娃，线下实体奖品的强互动玩法。
打印机
弹幕内容、中奖名单、订单信息通过热敏打印机实时出票，也支持「打印机猜词语」玩法。
KO 排行榜
把礼物换算成“伤害值”，累计决出排行榜。适合对战式、PK 式直播间：观众刷礼物为自己支持的一方加血/加伤， 大屏实时排行，并可通过继电器、激光打红牛等装置给出物理反馈。
| 平台配置项 | 可选值 | 说明 |
|---|---|---|
| 平台 | 抖音 / 快手 / B站 / 视频号 / 小红书 / 虎牙 / 斗鱼 / 淘宝直播 / TikTok 等全部主流平台 | 每个平台一套独立配置，可同时启用；其它平台可按需扩展 |
| 控制类型 | 报价排队 / 累计积分 / 抓钢珠 / 弹珠机 / 娃娃机 / 打印机 / KO排行榜 | 默认 KO 排行榜，按玩法选择 |
| 数据来源 | 默认 / 超人 / 抖音官方数据 | 按数据通道选择，抖音官方数据需对应授权 |
串口 + Modbus 继电器，动作精确到毫秒
「控制器」就是一块通过 USB 转串口连接的继电器板。每个控制器可单独配置通讯参数与执行方式。
控制器（串口）参数
- 串口号自动枚举，插上即选，支持手动填写
- 波特率 9600 / 19200 / 38400 / 57600 / 115200 / 230400
- 数据位、校验位（无/奇/偶/标记/空格）、停止位可调
- 数据下发间隔可设置，避免指令过快导致设备丢包
- 执行方式可选「继电器分别执行」或「继电器同时执行」；选择同时执行时可勾选参与同时动作的回路
继电器（执行端）参数
- Modbus 从站号可填 1–8 或自定义，多块板级联不冲突
- 继电器编号支持 1–8 路，也可选「全部」同时动作
- 时间类型支持秒 / 毫秒，长按、短促点动都能表达
- 时长、关闭时长、执行次数逐项可调
- 执行模式：普通 / 持续执行（关闭时间 -1）/ 一直执行（关闭时长 0）
六类直播事件，件件可以触发硬件
在「直播消息联动」里添加任意多条规则：选择事件类型、填写匹配内容、挂上要执行的动作。
| 消息类型 | 匹配字段（Key）的含义 | 常见用法 |
|---|---|---|
| 进入直播间 | 进房提示关键词，留空表示任何人进入都触发 | 欢迎语音、灯光提示 |
| 评论 | 评论关键词，如「666」「开」 | 弹幕决定动作、弹幕点歌 |
| 点赞 | 点赞事件关键词 | 点赞到量触发奖励 |
| 关注 | 关注事件关键词 | 关注送一次体验动作 |
| 礼物 | 礼物名称或礼物价值（见下方匹配方式） | 礼物触发继电器 / 娃娃机 / 打印 |
| 分享 | 分享事件关键词 | 分享助力、解锁玩法 |
精确礼物名称
礼物名称完全一致才触发，适合「一个礼物对应一个动作」的清晰玩法。
模糊礼物名称
名称包含关键词即触发，适合「所有玫瑰类礼物都算」这类玩法；列表里没有的礼物也能自定义填写。
礼物价值
按礼物价值触发，价值分层设计奖励：小礼物小动作，大礼物大招。
每条联动可配置的执行参数
执行按键（可填多个按键）、按键执行次数（达到该次数才真正触发）、分数（用于排行榜与积分累计）， 再叠加下方的语音、音乐与继电器输出，形成完整的“一次互动 → 一整套反馈”。
语音播报与音乐，让互动“有声音”
语音播报
- 每条联动可挂多段语音播报，按概率随机播放
- 支持触发门槛：按用户等级设置，等级不足不播报
- 等级填 -1 即关闭该类播报，随时一键静音
- 礼物 / 欢迎 / 点赞 / 评论 四类播报可分别设置
- 全局音量统一调节
音乐播放
- 从本地音乐库中选择播放文件，支持概率随机
- 可设置播放时长，多首音乐可叠加为随机歌单
- 与继电器动作并行执行，声音画面同步
- 配合语音播报形成“先播报、后音乐”的节奏
立即执行盲盒：把选择权交给概率
当执行方式切换为「立即执行盲盒」，这条联动就会按你设定的概率，从多组按键中随机抽取一组立即执行， 并播报对应文案——观众永远猜不到下一个是什么，节目效果最强。
概率权重
每一条盲盒都能设置概率值，越大越容易抽中，稀有玩法可以调低权重。
按键集合
每个盲盒可配置一组按键，抽中后按顺序执行，组合出无限可能。
专属播报
每条盲盒可单独配置播报文案，抽中什么就喊出什么。
可视化配置，改完即时生效
三栏流程图
控制器 → 键盘联动 → 语音/音乐/继电器，关系一目了然，连线清晰。
搜索与折叠
按按键、执行方式、备注搜索联动；一键全部展开/合上，配置项多也不乱。
列显示开关
控制器、键盘联动、语音、音乐列都能隐藏，专注编辑你当前关心的部分。
拖拽排序
拖动节点即可调整顺序，无需改配置文件。
单文件配置
所有配置存于一个 JSON 文件，便于备份、迁移与批量复制到多台机器。
一键重启服务
改完配置点「启动服务」，自动关闭旧进程并启动新的，无需手动操作任务管理器。