README.md · 其小本/抖音弹幕抓取数据推送

# 📺 抖音弹幕监听器

## 🔉前文提要

+ Github(受网络影响，更新很可能不及时)大佬请移步 [Gitee](https://gitee.com/haodong108/dy-barrage-grab) ，参与Issues讨论，QQ讨论群:819927029(进群前请⭐**Star**，谢谢🔪)
+ 发行版下载地址在[这里](https://gitee.com/haodong108/dy-barrage-grab/releases)，别下成源码包了!!，**决定下载使用前请先仔细阅读文档**，不要进群提问已经介绍到的问题
+ 💭 需要ws多直播间直连、自动私信，私信监听、自动发弹幕(正在修复)、获取榜单、礼物、直播间、用户主页信息、直播间其他所有消息类型解析 等功能的可以找我(QQ1083092844)提供一些技术支持(不支持匿名直播间)
+ 如果这个开源项目能帮老板们赚到玛尼，还望能请杯咖啡支持我更新下去(见底部<a href="#jz">捐赠通道</a>)

## ⛳近期更新
2024-03-10 v2.7.2

1. [**重要更新**] 支持设置为轮询模式监听(见配置项**forcePolling**，直播伴侣尚未支持)，比起ws更稳定，适合长时间监听
2. 支持进入直播间画面自动暂停
3. 优化礼物连击判定规则，可区分出可连击的礼物，进一步避免礼物数量推送不准确的问题，并新增字段:
   1. Combo 礼物是否可连击
   2. ImgUrl 礼物图像地址
   3. ToUser 送礼目标
4. roomId过滤改为 WebRoomid 过滤(仅支持已经被缓存的直播间，对直播伴侣可能无效)
5. 添加“关闭代理.bat” 批处理脚本，见根目录或者上方文件，便于无法上网时双击执行
6. 更多介绍请查看底下新增配置项

2023-11-23 v2.7.0

1. 修复了因抖音版本升级导致的WebRoomId获取不到的问题，并更近了正则表达式尽量兼容后续的变更
2. 添加了winfrom窗体，功能有限，默认隐藏
3. 支持了控制台隐藏，推送器弹幕类型过滤，日志弹幕类型过滤，弹幕文件日志  (见配置文件)
4. 支持了更多的ws命令，见 [Command.cs](./BarrageGrab/Modles/JsonEntity/Command.cs)

2023-11-04 v2.6.9

1. 修复了因抖音版本升级导致的WebRoomId获取不到的问题，并做了多重处理

2023-09-24 v2.6.8

1. 添加了上游代理支持，现在可以将无关的请求转发到其他的代理地址！详见下方配置说明`upstreamProxy`
2. 内部添加了webRoomid 的缓存映射，只要打开直播间地址即可缓存WebRoomId和Roomid的映射关系，`WebRoomId`现已添加至ws弹幕流数据中!，需要注意直播伴侣端提取的弹幕当前不会有该字段，除非在开播后打开浏览器访问一次你的直播间
3. MsgPack 现在添加了进程名字段`ProcessName`

2023-08-17 v2.6.7

1. [重要更新] 支持浏览器/客户端 http 弹幕监听，这也会解决原先版本因网络波动使抖音客户端弹幕获取方式降级，而获取不到弹幕导致必须刷新页面重新连接的问题。
2. [重要更新] 原先的web/客户端 页面无操作检测逻辑因官方js变动而失效，本次更新修复且完善了该功能，现在会定时模拟全局按键、绕过js检测逻辑、置空Websocket.close 方法三重手段尽量避免断开连接。你也可以直接修改[直播页脚本](./BarrageGrab/Scripts/inject/livePage.js)而无需重新编译源码。
3. ws连接现在默认监听在0.0.0.0地址，可以从其他客户端连接。
4. 代理端口现在可选择不占用系统代理，便于某些用户直接使用浏览器代理获取弹幕(启动时携带参数，例如:"chrome.exe --proxy-server=127.0.0.1:8827"，也可以在浏览器快捷方式-目标 引号之后附加该参数)

## 🖼️控制台截图

[![控制台截图](https://s1.ax1x.com/2022/11/10/z9YYPU.png)](https://imgse.com/i/z9YYPU)

## 😎介绍及配置

### 介绍

+ 基于系统代理抓包打造的抖音弹幕服务推送程序，它能够获取电脑上所有抖音弹幕来源数据，主要包括三种来源：**浏览器进程** ，**抖音客户端**，**抖音直播伴侣**。它可以监听**弹幕**，**点赞**，**关注**，**送礼**，**进入直播间**，**直播间统计**，**粉丝团**系列消息，你可使用它做自己的直播间数据分析，以及弹幕互动游戏，语音播报等。

### <a id="tag1">配置文件</a>

+ 程序中有基本的配置可以过滤弹幕进程，弹幕数据通过Websocket服务推送，其他程序只需接入ws服务器就能接收到到弹幕数据消息
 + 若下载发行版，则该配置文件在根目录下的 **WssBarrageService.exe.config** 可自主配置，配置后需要重新启动程序

``` xml

<appSettings>
  
  <add key="processFilter" value="直播伴侣,douyin,chrome,msedge,QQBrowser,360se,firefox,2345explorer,iexplore" />
  
  <add key="wsListenPort" value="8888" />
  
  <add key="listenAny" value="true" />
  
  <add key="proxyPort" value="8827" />
  
  <add key="upstreamProxy" value="" />
  
  <add key="printBarrage" value="true" />
  
  <add key="printFilter" value="" />
  
  <add key="pushFilter" value="" />
  
  <add key="logFilter" value="1,2,4,5,6,7,8" />
  
  <add key="webRoomIds" value="940152769375" />
  
  <add key="usedProxy" value="true" />
  
  <add key="filterHostName" value="true" />
  
  <add key="hostNameFilter" value="" />
  
  <add key="hideConsole" value="false" />
  
  <add key="barrageFileLog" value="false" />
  
  <add key="showWindow" value="false" />
  
  <add key="autoPause" value="true"/>
  
  <add key="forcePolling" value="false"/>
  
  <add key="pollingInterval" value="3000"/>
  
  <add key="disableLivePageScriptCache" value="true"/>
</appSettings>
```

### 推送数据格式

+ 弹幕数据由WebSocket服务进行分发，使用Json格式进行推送，见项目  [BarrageMessages.cs](./BarrageGrab/Modles/JsonEntity/BarrageMessages.cs)，如需调整请克隆项目后参照 [message.proto](./BarrageGrab/proto/message.proto) 进行源码修改调整，文件包含所有弹幕相关数据结构，可前往[ws在线测试](http://wstool.jackxiang.com/)网站，连接 ws://127.0.0.1:8888 进行测试

### 使用方法
1. 管理员身份启动本程序，第一次启动会提示安装自签名证书，程序启动后挂在后台不要关，不然再打开会监听不到正在进行中的直播弹幕。
2. 打开浏览器进入任何直播间进行测试，没有问题再启动直播伴侣
3. 如果需要对接自己的应用程序，请先了解 [WebSocket](https://www.bilibili.com/video/BV1KN411n7WD/?share_source=copy_web&vd_source=39ebf42c923024b9eddeca32c9e46d16) ，然后进行对接，可前往[这里](http://wstool.jackxiang.com/)测试

## 👨‍⚕️ 诊断排查

+ **启动后无法获取，排查清单**
  1. 先判断自己的浏览器进程名称是否在配置文件列表中
  2. 程序启动后，检查系统代理有无正常打开，有可能修改注册表被其他杀毒软件拦截
  3. 检查程序是否以管理员身份启动
  4. 注意程序启动先后顺序(很重要)，必须保证在进入直播间之前监听程序已在运行
  5. 检查代理端口是否与其他端口冲突，可尝试修改

+ **打开报错，排查清单**
  + *通用处理方法：*
    + 关闭杀毒软件，杀毒软件可能会阻止注册系统代理，访问端口号
    + 关闭Windows网络防火墙(设置-搜索) ，可能会阻止访问端口号

+ *以一种访问权限不允许的方式做了一个访问套接字的尝试*
    + 可能是端口被占用了，请尝试前往配置文件将8888端口号修改为别的号码(1000~65535)
    + 关杀毒

+ *尝试执行未经授权的操作*
    + 关杀毒

+ *以上都不行*
    + 请前往[这里](https://www.baidu.com/s?word=电脑购买)瞧瞧

+ **弹幕断连**

+ 如果浏览器总是连接一段时间后，就在在控制台看不到弹幕了，优先使用Chrome 和 Edge 浏览器，其他浏览器(例如360浏览器) 可能会存在该问题

+ 其他可能是网络原因，或者直播间断连导致，正在想办法优化解决中。。。需要长时间连接可以找我使用其他方式，支持直连和轮询获取方式

+ **程序关闭后无法上网**

+ 这是因为本程序运行时会占用系统代理，不正确的关闭方式可能会导致系统代理未能正确关闭，请前往找到 系统设置-网络和Internet-代理-使用代理服务器  并关闭它即可

## 🎲 辅助功能支持

+ **隐藏控制台**：	见配置文件 `hideConsole`
+ **远程控制程序**，例如远程关闭，隐藏/显示控制台，启用/关闭系统代理：
+ 发送Json数据包 `{"Cmd":xx,"Data":xx}` 到ws推送地址，数据格式详见: [Command.cs](./BarrageGrab/Modles/JsonEntity/Command.cs)
+ **启用弹幕文件日志**：
  + 见配置文件 `barrageFileLog`，启用后，抓到弹幕会记录在根目录 logs/弹幕日志 文件夹中，支持类型过滤，见`logFilter` 配置项

+ **上游代理设置**：
  + 一般用于自己有 代理工具/代理服务器，希望在使用本程序时访问外网不受到影响，见配置文件项`upstreamProxy` 将它改为你代理工具的代理地址
+ **UI界面**： 见配置文件 `showWindow `  (做的仓促，功能简陋)

## ⚠️特别注意

1. 程序只能监听到握手之后的ws数据包，例如先进入直播间或开启直播再打开本程序是无法监听到的，所以请保持程序后台运行

2. 由于打开系统代理需要自动检查/生成证书，所以程序需要管理员身份运行

3. 只有到达客户端的弹幕数据才能被接收，被抖音服务器过滤的弹幕是抓不到的

4. 关闭程序后若有无法上网的情况请检查: 网络和internet设置-->代理-->使用代理服务器 ，关闭即可

## 📢鸣谢

+ 请施舍一个 ⭐Start ，请及时订阅更新

+ 如果你也是开发者，欢迎提交你所擅长的语言的对接Demo，照拂新手朋友

## ⚖️免责声明

+ 本程序仅供学习参考，不得用于商业用途，不得用于恶意搜集他人直播间用户信息!
+ 请详细阅读[免责声明](./免责声明.txt)条款后进行使用

## 🍻支持一下?
开源不易

其小本/抖音弹幕抓取数据推送

简介

发行版

贡献者

近期动态

其小本/抖音弹幕抓取数据推送 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

其小本/抖音弹幕抓取数据推送