修改【protobuf实时弹幕】接口 并添加【protobuf历史弹幕】接口

This commit is contained in:
SocialSisterYi 2021-02-16 00:56:54 +08:00
parent 22b80b914a
commit f97772d8b1
2 changed files with 113 additions and 80 deletions

View File

@ -5,7 +5,6 @@
新的api是以6分钟为一个单位加载即每次加载6分钟内的弹幕
- [获取实时弹幕](#获取实时弹幕)
- [实例](#实例)
---
@ -38,6 +37,8 @@
**proto回复**
porto定义见[bilibili.community.service.dm.v1.DmSegMobileReply](..\grpc_api\bilibili\community\service\dm\v1.proto)
消息`DmSegMobileReply`
| 名称 | 类型 | 含义 | 备注 |
@ -61,94 +62,46 @@
| pool | int32 | 弹幕池 | 0普通池<br />1字幕池<br />2特殊池代码/BAS弹幕 |
| idStr | string | 弹幕dmID | 字串形式<br />唯一 可用于操作参数 |
protobuf结构体
**bilidm.proto**
```protobuf
syntax = "proto3";
message DanmakuElem {
int64 id = 1; //弹幕dmID
int32 progress = 2; //出现时间
int32 mode = 3; //弹幕类型
int32 fontsize = 4; //文字大小
uint32 color = 5; //弹幕颜色
string midHash = 6; //发送者UID的HASH
string content = 7; //弹幕内容
int64 ctime = 8; //发送时间
int32 weight = 9; //权重
string action = 10; //动作?
int32 pool = 11; //弹幕池
string idStr = 12; //弹幕dmID字串形式
}
message DmSegMobileReply {
repeated DanmakuElem elems = 1; //弹幕条目
}
```
**示例:**
获取视频`av810872(CID=1176840)`的实时弹幕分包1
获取视频`av810872(CID=1176840)`炮姐的实时弹幕分包1
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/web/seg.so' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=1176840' \
--data-urlencode 'pid=810872' \
--data-urlencode 'segment_index=1' \
-o 'danmaku.bin'
```
响应正文为protubuf二进制数据
## 实例
获取炮姐弹幕第1包[BV1Js411o76u](https://www.bilibili.com/video/BV1Js411o76u)
编译proto结构文件
```shell
protoc --python_out=. bilidm.proto
```
生成bilidm_pb2.py
---
以下为python测试代码输出第一包的第一条弹幕
**注proto定义需要编译**
```python
import bilidm_pb2
import requests
import google.protobuf.text_format as text_format
import bilibili.community.service.dm.v1_pb2 as Danmaku
AVID = 810872
CID = 1176840
SEG = 1
url = f'http://api.bilibili.com/x/v2/dm/web/seg.so?type=1&oid={CID}&pid={AVID}&segment_index={SEG}'
url = 'http://api.bilibili.com/x/v2/dm/web/seg.so'
params = {
'type':1, #弹幕类型
'oid':1176840, #cid
'pid':810872, #avid
'segment_index':1 #弹幕分段
}
resp = requests.get(url,params)
data = resp.content
data = requests.get(url)
target = bilidm_pb2.DmSegMobileReply()
target.ParseFromString(data.content)
danmaku_seg = Danmaku.DmSegMobileReply()
danmaku_seg.ParseFromString(data)
print(target.elems[0])
print(target.elems[0].content)
print(text_format.MessageToString(danmaku_seg.elems[0],as_utf8=True))
```
输出:
```
id: 682225690
progress: 44125
id: 711923911
progress: 47880
mode: 1
fontsize: 25
color: 16777215
midHash: "af4aa003"
content: "\346\210\221\347\202\256\350\277\230\350\203\275\345\206\215\346\210\230500\345\271\264\357\274\201\357\274\201\357\274\201\346\210\221\347\202\256\350\277\230\350\203\275\345\206\215\346\210\230500\345\271\264\357\274\201\357\274\201\357\274\201\346\210\221\347\202\256\350\277\230\350\203\275\345\206\215\346\210\230500\345\271\264\357\274\201\357\274\201\357\274\201\346\210\221\347\202\256\350\277\230\350\203\275\345\206\215\346\210\230500\345\271\264"
ctime: 1416323487
fontsize: 18
color: 10092288
midHash: "59417e95"
content: "世界第一电击公主殿下,遇到你是我一生最美好的风景!吾炮赛高,永生不离!唯我超电磁炮永世长存! "
ctime: 1418799826
weight: 6
idStr: "682225690"
我炮还能再战500年我炮还能再战500年我炮还能再战500年我炮还能再战500年
idStr: "711923911"
attr: 1
```

View File

@ -1,7 +1,10 @@
# 历史弹幕
**注历史弹幕的xml接口已经失效现已改为protobuf接口**
- [查询历史弹幕日期](#查询历史弹幕日期)
- [获取历史弹幕](#获取历史弹幕)
- [获取历史弹幕protobuf接口](#获取历史弹幕protobuf接口)
- [~~获取历史弹幕xml接口~~](#获取历史弹幕xml接口)
---
@ -13,6 +16,8 @@
认证方式CookieSESSDATA
**注:查询历史弹幕需要登录**
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@ -48,7 +53,8 @@
curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=144541892' \
--data-urlencode 'month=2020-01'
--data-urlencode 'month=2020-01' \
-b 'SESSDATA=xxx'
```
<details>
@ -83,7 +89,8 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=144541892' \
--data-urlencode 'month=2019-12'
--data-urlencode 'month=2019-12' \
-b 'SESSDATA=xxx'
```
<details>
@ -100,7 +107,73 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
</details>
## 获取历史弹幕
## 获取历史弹幕protobuf接口
> http://api.bilibili.com/x/v2/dm/web/history/seg.so
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1视频弹幕 |
| oid | num | 视频CID | 必要 | |
| date | str | 弹幕日期 | 必要 | YYYY-MM-DD |
**proto回复**
porto定义见[bilibili.community.service.dm.v1.DmSegMobileReply](..\grpc_api\bilibili\community\service\dm\v1.proto)
详细说明见[protobuf弹幕](danmaku_proto.md)
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕
**注proto定义需要编译**
```python
import requests
import google.protobuf.text_format as text_format
import bilibili.community.service.dm.v1_pb2 as Danmaku
url = 'http://api.bilibili.com/x/v2/dm/web/history/seg.so'
params = {
'type':1, #弹幕类型
'oid':144541892, #cid
'date':'2020-01-21' #弹幕日期
}
cookies = {
'SESSDATA':'xxx'
}
resp = requests.get(url,params,cookies=cookies)
data = resp.content
danmaku_seg = Danmaku.DmSegMobileReply()
danmaku_seg.ParseFromString(data)
print(text_format.MessageToString(danmaku_seg.elems[0],as_utf8=True))
```
输出:
```
id: 27532611677585408
progress: 300507
mode: 1
fontsize: 25
color: 16777215
midHash: "2a28d4a6"
content: "章北海的老爹"
ctime: 1579621359
idStr: "27532611677585408"
```
## 获取历史弹幕xml接口
<details>
<summary>查看折叠内容:</summary>
> http://api.bilibili.com/x/v2/dm/history
@ -108,6 +181,8 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
认证方式CookieSESSDATA
**注:查询历史弹幕需要登录**
结果为[标准xml格式弹幕](danmaku_xml.md#弹幕格式)
**使用deflate压缩注意解码**
@ -122,12 +197,15 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
**示例:**
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/history' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=144541892' \
--data-urlencode 'date=2020-01-21' \
--compressed -o 'danmaku.xml'
-b 'SESSDATA=xxx' \
--compressed -o 'danmaku.xml'
```
<details>
@ -163,4 +241,6 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history' \
<i>
```
</details>
</details>