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

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

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

url参数：

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

proto回复：

消息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	字串形式 唯一 可用于操作参数

protobuf结构体：

bilidm.proto

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

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

编译proto结构文件

protoc --python_out=. bilidm.proto

生成bilidm_pb2.py

---

以下为python测试代码，输出第一包的第一条弹幕

import bilidm_pb2
import requests

AVID = 810872
CID = 1176840
SEG = 1
url = 'http://api.bilibili.com/x/v2/dm/web/seg.so?type=1&oid=' + str(CID) + '&pid=' + str(AVID) + '&segment_index=' + str(SEG)

data = requests.get(url)
target = bilidm_pb2.DmSegMobileReply()
target.ParseFromString(data.content)

print(target.elems[0])
print(target.elems[0].content)

输出：

id: 682225690
progress: 44125
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
weight: 6
idStr: "682225690"

我炮还能再战500年！！！我炮还能再战500年！！！我炮还能再战500年！！！我炮还能再战500年