bilibili-API-collect/danmaku/danmaku_proto.md

# protobuf弹幕

2020年5月23日，哔哩哔哩网页端及移动端启用了新的默认弹幕api，网页端弹幕显示的上限变为原弹幕池上限的两倍。

新的api是以6分钟为一个单位加载，即每次加载6分钟内的弹幕

- [获取实时弹幕](#获取实时弹幕)

---

## 获取实时弹幕

> http://api.bilibili.com/x/v2/dm/web/seg.so （web端）
>
> http://api.bilibili.com/x/v2/dm/list/seg.so （APP端）
>
> http://i0.hdslb.com/bfs/dm/{data}.bin （BAS/代码弹幕专包）

*请求方式：GET*

此接口与漫画弹幕相同

只能返回普通弹幕（`pool=1` `mode=1-7`）和代码弹幕（`pool=2` `mode=8`），BAS弹幕（`pool=2` `mode=9`）请从[弹幕元数据](danmaku_view_proto.md)中获取

互动弹幕（UP主头像弹幕、关联视频、内嵌关注按钮）也不存在这个接口，请从[弹幕元数据](danmaku_view_proto.md)中获取

**注：仅获取6min的整数倍时间内的弹幕，6min内最多弹幕数为6000条（如第一包中弹幕`progress`值域为0-360000）**

**url参数：**

| 参数名        | 类型 | 内容     | 必要性 | 备注        |
| ------------- | ---- | -------- | ------ | ----------- |
| type          | num  | 弹幕类   | 必要   | 1：视频弹幕 |
| oid           | num  | 视频CID  | 必要   |             |
| pid           | num  | 稿件avID | 非必要 |             |
| segment_index | num  | 分包     | 必要   | 6分钟一包   |

**proto回复：**

porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api/bilibili/community/service/dm/v1.proto)

消息`DmSegMobileReply`：

| 名称  | 类型                 | 含义     | 备注 |
| ----- | -------------------- | -------- | ---- |
| elems | repeated DanmakuElem | 弹幕条目 |      |

消息`DanmakuElem`：

| 名称     | 类型   | 含义               | 备注                                                         |
| -------- | ------ | ------------------ | ------------------------------------------------------------ |
| id       | int64  | 弹幕dmID           | 唯一  可用于操作参数                                         |
| progress | int32  | 视频内弹幕出现时间 | 毫秒                                                         |
| mode     | int32  | 弹幕类型           | 1 2 3：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />6：逆向弹幕<br />7：高级弹幕<br />8：代码弹幕<br />9：BAS弹幕（仅限于特殊弹幕专包） |
| fontsize | int32  | 弹幕字号           | 18：小<br />25：标准<br />36：大                             |
| color    | uint32 | 弹幕颜色           | 十进制RGB888值                                               |
| midHash  | string | 发送者UID的HASH    | 用于屏蔽用户和查看用户发送的所有弹幕   也可反查用户ID        |
| content  | string | 弹幕内容           | utf-8编码                                                    |
| ctime    | int64  | 弹幕发送时间       | 时间戳                                                       |
| weight   | int32  | 权重               | 用于智能屏蔽，根据弹幕语义及长度通过AI识别得出<br />范围：[0-10]<br />值越大权重越高 |
| action   | string | 动作？             | 作用尚不明确                                                 |
| pool     | int32  | 弹幕池             | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕）      |
| idStr    | string | 弹幕dmID           | 字串形式<br />唯一  可用于操作参数                           |

**示例：**

获取视频`av810872(CID=1176840)`（炮姐）的实时弹幕分包1

**注：[proto定义](../grpc_api/bilibili/community/service/dm/v1/dm.proto)需要编译，`bilibili.community.service.dm.v1.dm_pb2`并非通过pypi安装**

```python
import requests
import google.protobuf.text_format as text_format
import bilibili.community.service.dm.v1.dm_pb2 as Danmaku

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

danmaku_seg = Danmaku.DmSegMobileReply()
danmaku_seg.ParseFromString(data)

print(text_format.MessageToString(danmaku_seg.elems[0],as_utf8=True))
```

输出：

```
id: 711923911
progress: 47880
mode: 1
fontsize: 18
color: 10092288
midHash: "59417e95"
content: "世界第一电击公主殿下,遇到你是我一生最美好的风景!吾炮赛高,永生不离!唯我超电磁炮永世长存! "
ctime: 1418799826
weight: 6
idStr: "711923911"
attr: 1
```