直播互动整蛊玩具

观众送礼/发弹幕 → 自动播放视频音效 + 模拟键鼠操作。基于 Electron + douyinLive。

前置依赖

douyinLive — 抖音直播 WebSocket 转发服务，需自行部署在本机。本工具通过它接收直播间的礼物和弹幕消息。

快速开始

直接使用

1. 启动 douyinLive
2. 从 Releases 下载并以管理员权限启动 liveToy.exe。打开控制面板后选择直播间即可。

媒体文件放入 exe 同目录下的 videos/ 和 audios/ 文件夹，配置文件在 client/config.json。

架构

src/
├── main.js              # Electron 入口，窗口管理 + HTTP :3001(播放) :3002(弹幕) :3003(日志)
├── dashboard.html       # 控制面板 — 连接管理 / 配置编辑 / 实时日志 / 动作测试
├── renderer.js          # 播放器前端（媒体队列）
├── rain-renderer.js     # 弹幕雨 Canvas 渲染
├── client/
│   ├── main.js          # WebSocket 客户端，连接 douyinLive，分发礼物/弹幕
│   ├── actions.js       # 键鼠动作（lookUp / holdMouse / combo / smoothSpin）
│   ├── win32input.js    # Win32 SendInput（鼠标相对移动）
│   ├── config.json      # WS 地址 + 礼物→(媒体+动作) 映射 + 组件开关
│   └── mock_server.js   # 本地测试 Mock 服务器
├── receiver.js          # 日志接收，按天写入 logs/
└── build-hook.js        # electron-builder 打包钩子

数据流：douyinLive →(WS)→ client/main.js →(HTTP)→ Player/Rain 窗口

配置示例

// src/client/config.json
{
    "WS_URL": "ws://localhost:1088/ws/<直播间ID>",
    "giftActions": {
        "人气票": {
            "mediaFile": "xxx.mp4",
            "action": { "name": "lookUp", "params": { "steps": 20 } }
        },
        "啤酒": {
            "mediaFile": "xxx.mp3"
        }
    },
    "components": { "player": true, "rain": true, "log": false }
}

• 视频放 videos/，音频放 audios/，程序按扩展名自动区分
• action.name 对应 actions.js 中导出的函数名

内置动作

动作	函数名	用途
上下看	lookUp	鼠标垂直相对移动
按住鼠标	holdMouseForSeconds	先按 1 再持续按左键
旋转	smoothSpin	鼠标水平相对移动
组合键	combo	序列按键/点击

需管理员权限运行。在 actions.js 中导出新函数即可扩展。

免责声明

本工具仅供学习交流，请勿用于违规场景，使用风险自行承担。

• 与抖音、字节跳动无关
• 模拟键鼠操作可能被部分平台/游戏视为违规，使用后果自负
• MIT 协议"现状"提供，不附带任何担保

---

开发辅助：DeepSeek V4、Qwen3.6-Plus