硬件整蛊常见问题（FAQ）
接入前、配置中、开播后最容易遇到的疑问都整理在这里。没有找到答案？直接联系我们。
一、产品与接入
荔枝硬件整蛊是做什么的？和普通弹幕互动插件有什么区别？
普通弹幕插件做的是“屏幕上的特效”，荔枝硬件整蛊做的是“现实里的动作”。它把抖音、快手、B 站的礼物与弹幕事件，通过串口和继电器下发到真实硬件，让娃娃机、弹珠机、抓钢珠机、热敏打印机、激光打红牛装置、灯光电机等真正动起来，同时播放语音与音乐。
软件怎么下载和安装？
在首页「下载」区获取 Windows 免安装压缩包（ZIP），解压后双击「启动配置编辑器.bat」打开可视化配置界面，配置完串口与消息联动后点「启动服务」即可开播。
压缩包内含主程序、配置编辑器、礼物名称清单与排行榜展示页；语音与音乐素材（mp3 / 话术）请自备或联系我们获取，建议下载后核对 SHA-256 校验值。
支持哪些直播平台？可以同时开多个平台吗？
全部主流直播平台都支持：抖音、快手、哔哩哔哩、微信视频号、小红书、虎牙、斗鱼、淘宝直播、TikTok、YouTube 等，其它平台也可以按需扩展。每个平台一套独立配置（平台、控制类型、数据来源、消息联动），可以同时运行互不影响。
需要联网吗？断网会不会把硬件卡死？
软件需要能访问直播平台的弹幕/事件数据通道。硬件控制是本地串口下发，与网络无关；断网时只是收不到新的互动事件，硬件控制逻辑本身不会出错，重新连接后即可继续。
电脑配置要求高吗？
软件本体很轻量，常规直播电脑即可：Windows 10 / 11 64 位，能稳定运行直播伴侣的机器都够用。界面是内置的浏览器窗口（Edge / Chrome 内核），不需要额外安装浏览器。
二、硬件与接线
整套硬件需要买哪些东西？
基础三件套：① 一台 Windows 电脑；② 一块 USB 转串口模块（RS232/RS485）；③ 一块支持 Modbus 从站的继电器板。再根据玩法加设备本体，例如娃娃机、弹珠机、抓钢珠机、热敏打印机、激光灯/激光打红牛装置、电机或氛围灯。
继电器板怎么选？要几路的？
软件按“从站号 + 继电器编号”下发指令，支持 1–8 路继电器，也可以选择「全部」回路同时动作。路数按你的动作数量来定：只控制一个装置 1–2 路就够，需要多个装置分别动作建议 4 路或 8 路，多块板级联时用不同从站号区分。
串口号（COM 口）怎么确定？换了 USB 口会不会变？
配置编辑器里会枚举出当前电脑可用的串口，插上继电器板后下拉即可选择，也能手动填写。注意：换 USB 接口或重装驱动后串口号可能变化，如果发现硬件不动，先到设备管理器确认 COM 号，再回到配置里更新。
继电器吸合了但设备不动，是什么原因？
软件只负责让继电器动作，设备是否响应取决于接线与供电。常见原因：继电器触点没有正确串入设备电路、设备供电不足、共地问题、触点容量不够。建议先用万用表测触点通断，确认是继电器侧还是设备侧的问题。
三、配置与玩法
礼物匹配方式「精确 / 模糊 / 价值」怎么选？
精确：礼物名称完全一致才触发，适合一个礼物对应一个固定动作；模糊：名称包含关键词即触发，适合“所有玫瑰类都算”，列表里没有的礼物也能自己填写名称；价值：按礼物价值触发，适合做分层奖励，小礼物小动作、大礼物大招。
观众送一个礼物可以同时做几件事？
没有硬性限制。一条「直播消息联动」下面可以挂多段语音播报、多首音乐和多个继电器动作，每一项还能单独设置概率。也可以把执行方式切成「立即执行盲盒」，让系统按概率随机抽一组按键执行并播报对应文案。
「继电器分别执行」和「继电器同时执行」有什么区别？
分别执行：每路继电器按自己的时长依次动作，适合多个装置各做各的；同时执行：可以勾选参与同时动作的回路，让它们一起吸合，适合“整体启动”“全灯亮起”这类效果。
继电器的「执行模式」怎么理解？
普通：按时长与关闭时长循环执行；持续执行：关闭时间设为 -1，表示持续吸合不释放；一直执行：关闭时长设为 0，表示持续动作。配合执行次数就能表达点动、长按、反复点动等不同效果。
语音播报设置里的「用户等级」是什么？
它是播报门槛：填一个等级数字，表示达到该等级的用户才触发播报；填 -1 表示该类播报完全关闭（不播报）。礼物、欢迎、点赞、评论四类播报可以分别设置，音量在同一个面板里统一调节。
音乐和语音可以同时播吗？
可以各自独立配置：一边播报语音、一边播放背景音乐，也可以设置播放时长让音乐自动收尾。建议把「播报」放在联动的前段、「音乐」作为氛围铺底，听感更自然。
四、运维与排查
改了配置要重启电脑吗？
不需要。配置保存后点一次「启动服务」，程序会自动关闭旧进程并启动新的，几秒内生效。编辑器里也有「重新加载」可以读取磁盘上的最新配置。
配置怎么备份？换电脑能不能直接用？
所有配置都存在一个 JSON 文件里。把它复制到新电脑、在启动参数里指向该文件即可完全复用，键鼠联动、继电器参数、语音音乐、盲盒设置都会原样带过去。建议每次大改前手动复制一份备份。
双击后浏览器没自动打开怎么办？
软件会优先用系统自带 Edge/Chrome 的应用窗口打开界面，如果系统环境特殊没有弹出，直接手动在浏览器访问本地地址即可（默认 127.0.0.1:8770）。控制台窗口也会打印提示信息，方便判断原因。
礼物来了但硬件没反应，按什么顺序排查？
建议顺序：① 看弹幕平台是否连上（数据来源与控制类型是否匹配）；② 看上报的礼物名称是否与你填写的匹配方式一致（值匹配要填价值而不是名称）；③ 看继电器板串口是否选对、板子指示灯有没有动作；④ 看继电器参数是否被设成了“持续执行/一直执行”等特殊模式；⑤ 最后再查接线与设备供电。
五、合规与售后
使用硬件整蛊直播需要遵守哪些规则？
必须遵守对应直播平台的内容与互动规范：不进行危险动作、不设置伤害性或歧视性惩罚、不做诱导违规打赏的玩法。设备侧请做好漏电保护与绝缘，涉及机械动作的装置要有防护措施，由主播自行评估安全风险。
支持定制玩法吗？
支持。控制模式、设备类型、消息联动与语音播报都是配置项，常规需求通过配置即可完成；如果有特殊硬件协议或平台接入需求，可以联系我们评估定制。
怎么联系你们？
请到联系我们，或使用页脚里的商务微信、客服 QQ 与邮箱。咨询时建议一并说明：直播平台、玩法类型、硬件型号与数量，我们能更快给出配置方案。