jwwsjlm / douyinLive

抖音直播弹幕抓取工具 🎬 基于 WebSocket 的抖音直播实时数据抓取工具，支持弹幕、礼物、点赞等多种消息类型。 --- ✨ 功能特性 • 🚀 **实时监控** - WebSocket 推送，毫秒级延迟 • 📊 **多房间支持** - 单进程监控多个直播间 • 🎁 **完整数据** - 弹幕、礼物、点赞、关注、进场等消息 • 🔧 **灵活配置** - 配置文件 + 命令行参数双支持 • 💡 **友好提示** - 详细的错误提示和解决方法 • 🛠️ **易于集成** - JSON 格式输出，方便二次开发 --- 🚀 快速开始 方式一：下载编译好的程序（推荐） • 从 Releases 下载最新版本 • 在同目录创建 配置文件（可选，用于设置默认端口）： • 运行程序： • **连接 WebSocket**（重要！房间号从这里指定）： 方式二：命令行启动 方式三：源码编译 --- 📖 使用说明 连接 WebSocket 服务启动后，客户端可以通过 WebSocket 连接： **示例：** 连接 WebSocket 服务启动后，客户端可以通过 WebSocket 连接： **JavaScript 示例：** 多房间监控 单个进程即可监控多个直播间，每个 WebSocket 连接指定不同的房间号： --- ⚙️ 配置说明 配置文件 (config.yaml) 命令行参数 | 参数 | 说明 | 默认值 | 是否必须 | |-------------|----------------|-------------|----------| | | WebSocket 服务端口 | 1088 | 否 | | | 直播间号（仅用于配置验证） | 无 | 是（启动时验证） | | | 是否输出未知消息类型 | false | 否 | | | 指定配置文件路径 | config.yaml | 否 | **重要提示：** 参数在启动时用于验证配置完整性，但实际运行时使用的房间号是从 WebSocket 连接 URL 中提取的！ --- 📡 消息类型 支持的消息类型（持续更新中）： | 类型 | 说明 | |-----------------------------|-------------| | | 弹幕消息 | | | 礼物消息 | | | 点赞消息 | | | 进场消息 | | | 关注消息 | | | 在线观众列表 | | | 粉丝团消息 | | | 控制消息（开播/下播） | | | 表情消息 | | | 直播间统计 | | | 房间消息 | | | 房间排名消息 | --- 🔧 高级用法 心跳机制 客户端需要每 30 秒发送一次心跳： 错误处理 消息解析示例 --- 🛠️ 开发指南 项目结构 房间号获取流程 添加新的消息类型 • 在 目录下更新 文件 • 运行 生成 Go 代码 • 在 中添加消息处理逻辑 Proto 文件参考： • 抖音官方：https://lf-cdn-tos.bytescm.com/obj/static/webcast/douyin_live/chunks/live-schema.0fa7e4bc.js • 社区版本：https://github.com/Remember-the-past/douyin_proto --- 📸 运行截图 服务启动 心跳测试 --- 🙏 致谢 本项目灵感来自： • DouyinLiveWebFetcher • douyin_proto 感谢以上作者的无私贡献！ --- 📄 许可证 MIT License --- 🐛 问题反馈 遇到问题？欢迎提 Issue！ 常见问题 | 问题 | 原因 | 解决方法 | |----------|--------------------|------------------------------------| | 直播间号不能为空 | 启动时未指定 --room 参数 | 使用 启动（仅用于验证） | | 连接失败 | WebSocket URL 格式错误 | 确保格式为 | | 直播间未开播 | 指定的房间号未直播 | 检查房间号是否正确，或等待开播 | | 端口被占用 | 1088 端口已被使用 | 使用 指定其他端口 | --- 📬 联系方式 • GitHub: @jwwsjlm • 博客：https://blog.xsojson.com --- **如果这个项目对你有帮助，欢迎 Star ⭐️ 支持一下！**