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）请从弹幕元数据中获取

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

注：仅获取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

消息DmSegMobileReply：

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

消息DanmakuElem：

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

示例：

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

注：proto定义需要编译

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/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