直播间信息流

获取信息流认证秘钥

https://api.live.bilibili.com/xlive/web-room/v1/index/getDanmuInfo

请求方法: GET

URL参数：

参数名	类型	内容	必要性	备注
id	num	直播间真实id	必要

JSON回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0: 成功 65530: token 错误 (登录错误) 1: 错误 60009: 分区不存在（其他错误码有待补充）
message	str	错误信息	默认为空
ttl	num	1
data	obj	信息本体

data 对象：

字段	类型	内容
group	str	live
business_id	num	0
refresh_row_factor	num	0.125
refresh_rate	num	100
max_delay	num	5000
token	str	认证秘钥
host_list	array	信息流服务器节点列表

data.host_list[n] 对象：

字段	类型	内容
host	str	服务器域名
port	num	TCP 端口
wss_port	num	WSS 端口
ws_port	num	WS 端口

示例:

获得直播间 14047 的信息流认证秘钥

curl -G 'https://api.live.bilibili.com/xlive/web-room/v1/index/getDanmuInfo' \
--url-query 'id=14047'

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "group": "live",
    "business_id": 0,
    "refresh_row_factor": 0.125,
    "refresh_rate": 100,
    "max_delay": 5000,
    "token": "IFfrzJxUd-K6mBPLGCpu-Z9QAz1V3KzIxde_-tCzvah05fYgfXjBWyuqRywF8Ov2w-MGQWt7l80pLiZEsfx3OPEDsXSRaJlzihV0hTXYwkiJvRmzMH3JjfAjdzlvI8sytUCrIbezBgbr_grGPd4ENTEknvu165L-ocW_cyql1e-L_EE=",
    "host_list": [
      {
        "host": "hw-sg-live-comet-02.chat.bilibili.com",
        "port": 2243,
        "wss_port": 443,
        "ws_port": 2244
      },
      {
        "host": "hw-sg-live-comet-01.chat.bilibili.com",
        "port": 2243,
        "wss_port": 443,
        "ws_port": 2244
      },
      {
        "host": "broadcastlv.chat.bilibili.com",
        "port": 2243,
        "wss_port": 443,
        "ws_port": 2244
      }
    ]
  }
}

数据包格式

数据包为 MQ (Message Queue, 消息队列) 使用 WebSocket 或 TCP 连接作为通道, 具体格式为头部数据 + 正文数据

注: 特别的, WS 与 WSS 连接地址带有路径 /sub, 如 wss://broadcastlv.chat.bilibili.com:443/sub.

再注: B 站更新了隐私政策, 连接建立 5 分钟左右, 若该连接认证时传入信息来自未登录用户, 会提示 为保护用户隐私，未注册登陆用户将无法查看他人昵称, 随后所有发送弹幕的用户 mid 都为 0, 用户名部分也使用 * 保护, 参见 #732

操作流程 (伪代码):

const s = new Socket(uri);
// 认证包
s.send('verify_hello');
s.receive('verfiy_reply');
// 心跳包
setInterval(() => {
  s.send('heartbeat');
  s.receive('heartbeat_reply');
}, 30000);
// 接收普通包
while (!s.isclosed()) {
  s.receive('normal_package');
}

头部格式:

偏移量	长度	类型	含义
0	4	uint32	封包总大小 (头部大小 + 正文大小)
4	2	uint16	头部大小 (一般为 0x0010, 即 16 字节)
6	2	uint16	协议版本: 0: 普通包 (正文不使用压缩) 1: 心跳及认证包 (正文不使用压缩) 2: 普通包 (正文使用 zlib 压缩) 3: 普通包 (使用 brotli 压缩的多个带文件头的普通包)
8	4	uint32	操作码 (封包类型)
12	4	uint32	sequence, 每次发包时向上递增

操作码:

代码	含义
2	心跳包
3	心跳包回复 (人气值)
5	普通包 (命令)
7	认证包
8	认证包回复

普通包可能包含多条命令, 每个命令有一个头部, 指示该条命令的长度等信息

数据包

认证包

方向: 上行

注: 连接成功后 5 秒内发送, 否则强制断开连接

JSON正文:

根对象:

字段	类型	内容	必要性	备注
uid	num	用户mid	非必要	0 即为游客登录
roomid	num	加入房间的id	必要	直播间真实id
protover	num	协议版本	非必要	3, 与数据包头部协议版本无关
platform	str	平台标识	非必要	`web`
type	num	2	非必要
key	str	认证秘钥	非必要

示例:

00000000: 0000 00ff 0010 0001 0000 0007 0000 0001  ................
00000001: 7b22 7569 6422 3a31 3630 3134 3836 3234  {"uid":160148624
00000002: 2c22 726f 6f6d 6964 223a 3232 3630 3831  ,"roomid":226081
00000003: 3132 2c22 7072 6f74 6f76 6572 223a 332c  12,"protover":3,
00000004: 2270 6c61 7466 6f72 6d22 3a22 7765 6222  "platform":"web"
00000005: 2c22 7479 7065 223a 322c 226b 6579 223a  ,"type":2,"key":
00000006: 2230 7670 5448 5737 7757 556e 6c6f 5270  "0vpTHW7wWUnloRp
00000007: 5251 6b47 764e 626e 7776 7364 6d2d 7159  RQkGvNbnwvsdm-qY
00000008: 4777 4243 5875 2d59 5164 6e57 7653 5547  GwBCXu-YQdnWvSUG
00000009: 7373 4139 7962 4b68 7932 6a78 3952 6f63  ssA9ybKhy2jx9Roc
0000000a: 4150 4651 6d54 4f6b 5277 6b4b 687a 4479  APFQmTOkRwkKhzDy
0000000b: 4839 5054 756f 5468 6834 4630 7562 584c  H9PTuoThh4F0ubXL
0000000c: 4964 6e69 3734 5539 304b 4242 6972 3248  Idni74U90KBBir2H
0000000d: 7451 3941 3777 674b 3438 4b7a 495f 5a5a  tQ9A7wgK48KzI_ZZ
0000000e: 3838 7557 4e59 6652 4f48 6964 4e6a 3732  88uWNYfROHidNj72
0000000f: 7061 796e 3479 3071 4268 513d 3d22 7d    payn4y0qBhQ=="}

认证包回复

方向: 下行

注: 在认证包发送成功后就会收到 JSON 正文, 若失败则返回 HTTP/0.9 的 403

JSON正文:

根对象:

字段	类型	内容	备注
code	num	返回值	0: 认证成功

示例:

00000000: 0000 001a 0010 0001 0000 0008 0000 0001  ................
00000001: 7b22 636f 6465 223a 307d                 {"code":0}

心跳包

方向: 上行

注: 30 秒左右发送一次, 否则 60 秒后会被强制断开连接

正文:

可以为空或任意字符

示例:

00000000: 0000 001f 0010 0001 0000 0002 0000 0001  ................
00000001: 5b6f 626a 6563 7420 4f62 6a65 6374 5d    [object Object]

心跳包回复 (人气值)

方向: 下行

注: 在心跳包发送成功后就会收到

正文:

正文分为两个部分

第一部分: uint32 整数代表的房间当前的人气值
第二部分: 心跳包正文内容

示例:

示例房间内人气值为 2466 (0x000009a2)

00000000: 0000 0014 0010 0001 0000 0003 0000 0000  ................
00000001: 0000 09a2 5b6f 626a 6563 7420 4f62 6a65  ....[object Obje
00000002: 6374 5d                                  ct]

普通包

方向: 下行

正文:

一般为普通 JSON 数据

大多数普通包都经过 zlib 或 brotli 压缩

示例:

00000000: 0000 0086 0010 0003 0000 0005 0000 0000  ................
00000001: 8b38 8000 0000 7200 1000 0000 0000 0500  .8....r.........
00000002: 0000 007b 2263 6d64 223a 2257 4154 4348  ...{"cmd":"WATCH
00000003: 4544 5f43 4841 4e47 4522 2c22 6461 7461  ED_CHANGE","data
00000004: 223a 7b22 6e75 6d22 3a32 3230 3937 2c22  ":{"num":22097,"
00000005: 7465 7874 5f73 6d61 6c6c 223a 2232 2e32  text_small":"2.2
00000006: e4b8 8722 2c22 7465 7874 5f6c 6172 6765  ...","text_large
00000007: 223a 2232 2e32 e4b8 87e4 baba e79c 8be8  ":"2.2..........
00000008: bf87 227d 7d03                           .."}}.

弹幕 (DANMU_MSG)

注: 当收到弹幕时接收到此条消息, 10 进制转 16 进制若位数不足则在左侧补 0

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`DANMU_MSG`
dm_v2	str	空串?
info	array	弹幕信息	感谢 #1084 补充

info 数组:

项	类型	内容	备注
0	array	弹幕信息	大部分信息可从 `info[0][15].extra` 获取
1	str	弹幕文本
2	array	发送者信息	大部分信息可从 `info[0][15].user` 获取
3	array	发送者粉丝勋章信息	若无则为空
4	array	发送者UL等级信息
5	array	?
6	num	0?
7	num	0?
8	null
9	obj	发送时间戳
10	num	0?
11	num	0?
12	null
13	null
14	num	0?
15	num	?
16	array	?

info[0] 数组:

项	类型	内容	备注
0	num
1	num	弹幕模式	弹幕的 mode 字段
2	num	弹幕字体大小	弹幕的 fontsize 字段
3	num	弹幕颜色	弹幕的 color 字段十六进制颜色值的十进制数字
4	num	发送时的 UNIX 毫秒时间戳	弹幕的 rnd 字段
5	num		一个负整数
6	num	0?
7	str	可能为颜色?	一个 16 进制数
8	num	0?
9	num	0?
10	num	0?
11	str	空串?
12	num	0?
13	str	字符串表示的 JSON Object	空?
14	str	字符串表示的 JSON Object	空?
15	obj	弹幕补充信息
16	obj	活动相关信息?
17	num	0?
18	null

info[0][15] 对象:

字段	类型	内容	备注
extra	str	弹幕信息	字符串表示的 JSON
mode	num	弹幕模式?
show_player_type	num	0?
user	obj	用户相关信息

info[0[[15].extra 表示的对象:

见下方 JSONC

{
  "send_from_me": false,      // 是否由该接收消息的用户发送
  "mode": 0,                  // 弹幕模式 (info[0][1])
  "color": 9920249,           // 弹幕颜色 (info[0][3])
  "dm_type": 0,
  "font_size": 25,            // 弹幕字体大小 (info[0][2])
  "player_mode": 1,
  "show_player_type": 0,
  "content": "白花300块[热]", // 弹幕文本 (info[1])
  "user_hash": "197700816",
  "emoticon_unique": "",
  "bulge_display": 0,
  "recommend_score": 3,
  "main_state_dm_color": "",
  "objective_state_dm_color": "",
  "direction": 0,             // 弹幕方向?
  "pk_direction": 0,
  "quartet_direction": 0,
  "anniversary_crowd": 0,
  "yeah_space_type": "",
  "yeah_space_url": "",
  "jump_to_url": "",
  "space_type": "",
  "space_url": "",
  "animation": {},
  "emots": {                  // 表情相关信息 (用于文本替换)
    "[热]": {
      "count": 1,
      "descript": "[热]",
      "emoji": "[热]",
      "emoticon_id": 278,
      "emoticon_unique": "emoji_278",
      "height": 20,
      "url": "http://i0.hdslb.com/bfs/live/6df760280b17a6cbac8c1874d357298f982ba4cf.png",
      "width": 20
    }
  },
  "is_audited": false,
  "id_str": "364b06e3c561af3d5921f1253d66c1d575",
  "icon": {
    "prefix": {
      "type": 1,
      "resource": "ChronosWealth_4.png"
    }
  },
  "show_reply": true,         // 显示回复?
  "reply_mid": 0,
  "reply_uname": "",
  "reply_uname_color": "",
  "reply_is_mystery": false,
  "hit_combo": 0
}

info[0][15].user 对象:

字段	类型	内容	备注
base	obj	基本信息
guard	null
guard_leader	obj	?
medal	obj	粉丝排信息	参见指定用户的所有粉丝勋章信息 `data.list[n].uinfo_medal`
title	obj	?
uhead_frame	null
uid	num	发送者 mid
wealth	null

info[0][15].user.base 对象:

字段	类型	内容	备注
face	str	发送者头像 URL
is_mystery	bool	是否是神秘用户?
name	str	发送者用户名
name_color	num	用户名颜色	10 进制
name_color_str	num	字符串表示的颜色
offical_info	obj	认证信息	参见用户空间详细信息 `data.official`
origin_info	obj	同 `face` `name`
risk_ctrl_info	null

info[0][15].user.title 对象:

字段	类型	内容	备注
old_title_css_id	str	空串?
title_css_id	str	空串?

info[0][16] 对象:

字段	类型	内容
activity_identity	str	空串?
activity_source	num	0?
not_show	num	0?

info[2] 数组:

项	类型	内容	备注
0	num	发送者 mid	同 `info[0][15].user.uid`
1	str	发送者用户名	同 `info[0][15].user.base.name`
2	num	0?
3	num	0?
4	num	0?
5	num	用户权限等级?	参见用户空间详细信息 `data.rank`
6	num	?

info[3] 数组:

项	类型	内容
0	num	同 `info[0][15].user.medal.level`
1	str	同 `info[0][15].user.medal.name`
2	str	粉丝牌创建主播名称
3	num	?
4	num	同 `info[0][15].user.medal.color`
5	str	空串?
6	num	0?
7	num	同 `info[0][15].user.medal.color_border`
8	num	同 `info[0][15].user.medal.color_start`
9	num	同 `info[0][15].user.medal.color_end`
10	num	同 `info[0][15].user.medal.guard_level`
11	num	同 `info[0][15].user.medal.is_light`
12	num	同 `info[0][15].user.medal.ruid`

info[4] 数组:

项	类型	内容
0	num	?
1	num	?
2	num	?
3	num	?
4	num	?

info[5] 数组:

项	类型	内容	备注
0	str	空串?
1	str	空串?

info[9] 对象:

字段	类型	内容	备注
ct	str	?	16 进制
ts	num	发送时间	UNIX 秒级时间戳

info[16] 数组:

项	类型	内容	备注
0	num	?

示例:

查看消息示例(带注释):

{
  "cmd": "DANMU_MSG",
  "dm_v2": "",
  "info": [
    [
      0,
      1,
      25, //字体大小
      9920249, //弹幕颜色代码(10进制)#975ef9
      1723979200649,
      -1312973962,
      0,
      "0bc8acd0",
      0,
      0,
      0,
      "",
      0,
      "{}",
      "{}",
      {
        "extra": "{\"send_from_me\":false,\"mode\":0,\"color\":9920249,\"dm_type\":0,\"font_size\":25,\"player_mode\":1,\"show_player_type\":0,\"content\":\"白花300块[热]\",\"user_hash\":\"197700816\",\"emoticon_unique\":\"\",\"bulge_display\":0,\"recommend_score\":3,\"main_state_dm_color\":\"\",\"objective_state_dm_color\":\"\",\"direction\":0,\"pk_direction\":0,\"quartet_direction\":0,\"anniversary_crowd\":0,\"yeah_space_type\":\"\",\"yeah_space_url\":\"\",\"jump_to_url\":\"\",\"space_type\":\"\",\"space_url\":\"\",\"animation\":{},\"emots\":{\"[热]\":{\"count\":1,\"descript\":\"[热]\",\"emoji\":\"[热]\",\"emoticon_id\":278,\"emoticon_unique\":\"emoji_278\",\"height\":20,\"url\":\"http://i0.hdslb.com/bfs/live/6df760280b17a6cbac8c1874d357298f982ba4cf.png\",\"width\":20}},\"is_audited\":false,\"id_str\":\"364b06e3c561af3d5921f1253d66c1d575\",\"icon\":{\"prefix\":{\"type\":1,\"resource\":\"ChronosWealth_4.png\"}},\"show_reply\":true,\"reply_mid\":0,\"reply_uname\":\"\",\"reply_uname_color\":\"\",\"reply_is_mystery\":false,\"hit_combo\":0}",
        "mode": 0,
        "show_player_type": 0,
        "user": {
          "base": {
            "face": "https://i1.hdslb.com/bfs/face/5a9bb9cac3afbb58347c808ae76aaa41ca967d07.jpg", //弹幕发送用户头像
            "is_mystery": false,
            "name": "tim1997", //弹幕发送用户名称
            "name_color": 0,
            "name_color_str": "",
            "official_info": {
              "desc": "",
              "role": 0,
              "title": "",
              "type": -1
            },
            "origin_info": {
              "face": "https://i1.hdslb.com/bfs/face/5a9bb9cac3afbb58347c808ae76aaa41ca967d07.jpg",
              "name": "tim1997"
            },
            "risk_ctrl_info": null
          },
          "guard": null,
          "guard_leader": {
            "is_guard_leader": false
          },
          "medal": {
            "color": 2951253, //粉丝牌颜色(10进制)#2d0855
            "color_border": 16771156, //粉丝牌边框颜色(10进制)#ffe854
            "color_end": 10329087, //粉丝牌渐变颜色结束(10进制)#9d9bff
            "color_start": 2951253, //粉丝牌渐变颜色开始(10进制)#2d0855
            "guard_icon": "https://i0.hdslb.com/bfs/live/1d16bf0fcc3b1b768d1179d60f1fdbabe6ab4489.png", //粉丝牌左边的图标
            "guard_level": 1, //类型 1.总督 2.提督 3，舰长
            "honor_icon": "",
            "id": 1279130,
            "is_light": 1,
            "level": 29, //粉丝牌等级
            "name": "果咩吖", //粉丝牌名称
            "ruid": 3546569288714792, //粉丝牌创建者UID
            "score": 50427312,
            "typ": 0,
            "user_receive_count": 0,
            "v2_medal_color_border": "#D47AFFFF", //粉丝牌边框颜色(APP)
            "v2_medal_color_end": "#9660E5CC", //粉丝牌渐变颜色结束(APP)
            "v2_medal_color_level": "#6C00A099", //粉丝牌右边等级数字颜色(APP)
            "v2_medal_color_start": "#9660E5CC", //粉丝牌渐变颜色开始(APP)
            "v2_medal_color_text": "#FFFFFFFF" //粉丝牌右边圆形颜色(APP)
          },
          "title": {
            "old_title_css_id": "",
            "title_css_id": ""
          },
          "uhead_frame": null,
          "uid": 6088969, //弹幕发送用户UID
          "wealth": null
        }
      },
      {
        "activity_identity": "",
        "activity_source": 0,
        "not_show": 0
      },
      0
    ],
    "白花300块[热]", //弹幕内容
    [
      6088969, //同info[0][15].user.uid
      "tim1997", //同info[0][15].user.base.name
      0,
      0,
      0,
      10000,
      1,
      ""
    ],
    [
      29, //同info[0][15].user.medal.level
      "果咩吖", //同info[0][15].user.medal.name
      "果宝Official", //粉丝牌创建主播名称
      31180317,
      2951253, //同info[0][15].user.medal.color
      "",
      0,
      16771156, //同info[0][15].user.medal.color_border
      2951253, //同info[0][15].user.medal.color_start
      10329087, //同info[0][15].user.medal.color_end
      1, //同info[0][15].user.medal.guard_level
      1, //同info[0][15].user.medal.is_light
      3546569288714792 //同info[0][15].user.medal.ruid
    ],
    [
      39,
      0,
      10512625,
      42523,
      2
    ],
    [
      "",
      ""
    ],
    0,
    0,
    null,
    {
      "ct": "AFFF4206",
      "ts": 1723979200 //时间戳(秒级)
    },
    0,
    0,
    null,
    null,
    0,
    1040,
    [
      49
    ],
    null
  ]
}

连续弹幕消息 (DM_INTERACTION)

注: 连续多条相同弹幕时触发

JSON正文:

根对象:

字段	类型	内容	备注
cmd	str	`DM_INTERACTION`
data	obj	信息本体

data 对象:

字段	类型	内容
id	num	事件 ID
status	num	状态
type	num	事件类型
data	str	事件数据

data.data 对象:

字段	类型	内容
combo	array	连续发送弹幕事件信息
merge_interval	num	合并弹幕时间间隔
card_appear_interval	num	弹窗出现时间间隔
send_interval	num	发送时间间隔

data.data.combo[n] 对象:

字段	类型	内容	备注
id	num	标识 ID
status	num	状态
content	str	重复的弹幕内容
cnt	num	重复数量
guide	str	标题词	"他们都在说:"
left_duration	num	左移时长
fade_duration	num	淡化时长

示例:

查看正文示例:

{
  "cmd": "DM_INTERACTION",
  "data": {
    "id": 6785480089600,
    "status": 4,
    "type": 102,
    "data": {
      "combo": [
        {
          "id": 6785480089600,
          "status": 4,
          "content": "晚安",
          "cnt": 3,
          "guide": "他们都在说:",
          "left_duration": 20000,
          "fade_duration": 60000
        }
      ],
      "merge_interval": 1000,
      "card_appear_interval": 1000,
      "send_interval": 1000
    }
  }
}

进场或关注消息 (INTERACT_WORD)

注: 有用户进入直播间或关注主播时触发

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`INTERACT_WORD`
data	obj	进入直播间的用户的信息

data 对象:

字段	类型	内容
contribution	obj	待调查
dmscore	num	待调查
fans_medal	obj	粉丝勋章
identities	num	待调查
is_spread	num	待调查
msg_type	num	1为进场，2为关注
roomid	num	房间号
is_spread	num	待调查
is_spread	num	待调查
score	num	待调查
spread_desc	str	待调查
spread_info	str	待调查
tail_icon	num	待调查
timestamp	num	时间戳
trigger_time	num	触发时间
uid	num	用户ID
uname	str	用户名称
uname_color	str	用户名称颜色

示例:

查看消息示例:

{
  "cmd": "INTERACT_WORD",
  "data": {
    "contribution": {
      "grade": 0
    },
    "dmscore": 4,
    "fans_medal": {
      "anchor_roomid": 890976,
      "guard_level": 0,
      "icon_id": 0,
      "is_lighted": 0,
      "medal_color": 6067854,
      "medal_color_border": 12632256,
      "medal_color_end": 12632256,
      "medal_color_start": 12632256,
      "medal_level": 1,
      "medal_name": "小豆皮",
      "score": 134,
      "special": "",
      "target_id": 6574487
    },
    "identities": [
      1
    ],
    "is_spread": 0,
    "msg_type": 1,
    "roomid": 24143902,
    "score": 1644563948936,
    "spread_desc": "",
    "spread_info": "",
    "tail_icon": 0,
    "timestamp": 1644563948,
    "trigger_time": 1644563947876475000,
    "uid": 335979315,
    "uname": "TIM_Init",
    "uname_color": ""
  }
}

上舰通知 (GUARD_BUY)

注: 当有用户购买舰长 / 提督 / 总督时

JSON消息:

字段	类型	内容	备注
cmd	str	`GUARD_BUY`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
uid	num	用户ID
username	str	用户名称
guard_level	num	大航海等级	1: 总督 2: 提督 3:舰长
num	num	数量
price	num	原金瓜子标价	即 CNY*1000
gift_id	num	礼物id
gift_name	str	礼物名称
start_time	num	待调查
end_time	num	待调查

示例:

查看消息示例:

{
  "cmd": "GUARD_BUY",
  "data": {
    "uid": 14225357,
    "username": "妙妙喵喵妙妙喵O_O",
    "guard_level": 3,
    "num": 1,
    "price": 198000,
    "gift_id": 10003,
    "gift_name": "舰长",
    "start_time": 1677069316,
    "end_time": 1677069316
  }
}

用户庆祝消息 (USER_TOAST_MSG)

注: 用户购买舰长 / 提督 / 总督后的庆祝消息, 内容包含用户陪伴天数

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`USER_TOAST_MSG`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
anchor_show	bool	是否显示
color	str	颜色
dmscore	num	待调查
effect_id	num	待调查
face_effect_id	num	待调查
gift_id	num	礼物id
group_name	str	待调查
group_op_type	num	待调查
group_role_name	str	待调查
guard_level	num	大航海等级	1: 总督 2: 提督 3:舰长
is_group	num	待调查
is_show	num	待调查
num	num	上舰个数
op_type	num	待调查
payflow_id	str	待调查
price	num	实际金瓜子标价	即 CNY*1000
role_name	str	身份名称
room_effect_id	num	待调查
room_group_effect_id	num	待调查
start_time	num	待调查
svga_block	num	待调查
target_guard_count	str	庆祝消息正文
toast_msg	num	待调查
uid	num	上舰人UID
unit	str	购买身份时间单位
user_show	bool	待调查
username	str	上舰人用户名

示例:

查看消息示例:

{
  "cmd": "USER_TOAST_MSG",
  "data": {
    "anchor_show": true,
    "color": "#00D1F1",
    "dmscore": 90,
    "effect_id": 397,
    "end_time": 1702580687,
    "face_effect_id": 44,
    "gift_id": 10003,
    "group_name": "",
    "group_op_type": 0,
    "group_role_name": "",
    "guard_level": 3,
    "is_group": 0,
    "is_show": 0,
    "num": 1,
    "op_type": 1,
    "payflow_id": "2312150304155852173446521",
    "price": 138000,
    "role_name": "舰长",
    "room_effect_id": 590,
    "room_group_effect_id": 1337,
    "start_time": 1702580687,
    "svga_block": 0,
    "target_guard_count": 146,
    "toast_msg": "<%无光之日%> 在主播Mia米娅-的直播间开通了舰长，今天是TA陪伴主播的第1天",
    "uid": 79667344,
    "unit": "月",
    "user_show": true,
    "username": "无光之日"
  }
}

醒目留言 (SUPER_CHAT_MESSAGE)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`SUPER_CHAT_MESSAGE`
data	obj	信息本体
roomid	num	直播间房间号 (非短号)

data 对象:

字段	类型	内容	备注
background_bottom_color	str	待调查
background_color	str	待调查
background_color_end	str	待调查
background_color_start	str	待调查
background_icon	str	待调查
background_image	str	待调查
background_price_color	str	待调查
color_point	num	待调查
dmscore	num	待调查
end_time	num	待调查
gift	obj	礼物信息
id	num	醒目留言 ID
is_ranked	num	待调查
is_send_audit	num	待调查
medal_info	obj	SC发送用户佩戴的粉丝牌信息
message	str	sc内容
message_font_color	str	SC文本颜色
message_trans	str	机翻sc内容
price	num	sc金额	为 CNY 价值
rate	num	待调查
start_time	num	待调查
time	num	sc持续时间
token	num	待调查
trans_mark	num	待调查
ts	num	待调查
uid	num	发送用户uid
user_info	obj	发送用户信息

data.gift 对象:

字段	类型	内容	备注
gift_id	num	礼物id
gift_name	str	礼物名称	一般均为"醒目留言"
num	num	数量

data.medal_info 对象:

字段	类型	内容	备注
anchor_roomid	num	房间号	包含短号
anchor_uname	str	主播昵称
guard_level	num	大航海等级	1: 总督 2: 提督 3: 舰长
icon_id	num	待调查
is_lighted	num	待调查
medal_color	str	待调查
medal_color_border	num	待调查
medal_color_end	num	待调查
medal_color_start	num	待调查
medal_level	num	粉丝牌等级
medal_name	str	粉丝牌名称
special	str	待调查
target_id	num	粉丝牌对应的主播mid

data.user_info 对象:

字段	类型	内容	备注
face	num	用户头像
face_frame	num	头像边框
guard_level	num	大航海等级	1: 总督 2: 提督 3: 舰长
is_main_vip	num	待调查
is_svip	num	待调查
is_vip	num	待调查
level_color	str	待调查
manager	num	待调查
name_color	str	待调查
title	str	待调查
uname	str	用户名称
user_level	num	待调查

示例:

查看消息示例:

{
  "cmd": "SUPER_CHAT_MESSAGE",
  "data": {
    "background_bottom_color": "#2A60B2",
    "background_color": "#EDF5FF",
    "background_color_end": "#405D85",
    "background_color_start": "#3171D2",
    "background_icon": "",
    "background_image": "https://i0.hdslb.com/bfs/live/a712efa5c6ebc67bafbe8352d3e74b820a00c13e.png",
    "background_price_color": "#7497CD",
    "color_point": 0.7,
    "dmscore": 120,
    "end_time": 1677069095,
    "gift": {
      "gift_id": 12000,
      "gift_name": "醒目留言",
      "num": 1
    },
    "id": 6522809,
    "is_ranked": 1,
    "is_send_audit": 0,
    "medal_info": {
      "anchor_roomid": 732,
      "anchor_uname": "Asaki大人",
      "guard_level": 3,
      "icon_id": 0,
      "is_lighted": 1,
      "medal_color": "#1a544b",
      "medal_color_border": 6809855,
      "medal_color_end": 5414290,
      "medal_color_start": 1725515,
      "medal_level": 21,
      "medal_name": "ASAKI",
      "special": "",
      "target_id": 194484313
    },
    "message": "猪播完美预测自己第一个死，这就是鹅鸭杀高玩吗",
    "message_font_color": "#A3F6FF",
    "message_trans": "",
    "price": 30,
    "rate": 1000,
    "start_time": 1677069035,
    "time": 60,
    "token": "7BED5681",
    "trans_mark": 0,
    "ts": 1677069035,
    "uid": 294094150,
    "user_info": {
      "face": "https://i1.hdslb.com/bfs/face/7a11b48e0a3055e220fa8b4c7d938cd4bcac2577.jpg",
      "face_frame": "https://i0.hdslb.com/bfs/live/80f732943cc3367029df65e267960d56736a82ee.png",
      "guard_level": 3,
      "is_main_vip": 1,
      "is_svip": 0,
      "is_vip": 0,
      "level_color": "#969696",
      "manager": 0,
      "name_color": "#00D1F1",
      "title": "0",
      "uname": "界原虚",
      "user_level": 6
    }
  },
  "roomid": 6154037
}

醒目留言日语 (SUPER_CHAT_MESSAGE_JPN)

基本同醒目留言 (SUPER_CHAT_MESSAGE), 但多了 message_jpn 字段

示例:

查看消息示例:

{
  "cmd": "SUPER_CHAT_MESSAGE_JPN",
  "data": {
    "id": "3790747",
    "uid": "394060741",
    "price": 30,
    "rate": 1000,
    "message": "棉花！！转盘中了武器后，上号30抽3武器，救命！！！",
    "message_jpn": "",
    "is_ranked": 1,
    "background_image": "https://i0.hdslb.com/bfs/live/a712efa5c6ebc67bafbe8352d3e74b820a00c13e.png",
    "background_color": "#EDF5FF",
    "background_icon": "",
    "background_price_color": "#7497CD",
    "background_bottom_color": "#2A60B2",
    "ts": 1650363318,
    "token": "24655ABF",
    "medal_info": {
      "icon_id": 0,
      "target_id": 1871001,
      "special": "",
      "anchor_uname": "棉花大哥哥",
      "anchor_roomid": 103,
      "medal_level": 24,
      "medal_name": "棉花花",
      "medal_color": "#1a544b"
    },
    "user_info": {
      "uname": "改了名真的能中吗",
      "face": "http://i1.hdslb.com/bfs/face/e2391f132cd981fb70468a8ce9418513e959eb10.jpg",
      "face_frame": "https://i0.hdslb.com/bfs/live/80f732943cc3367029df65e267960d56736a82ee.png",
      "guard_level": 3,
      "user_level": 11,
      "level_color": "#61c05a",
      "is_vip": 0,
      "is_svip": 0,
      "is_main_vip": 1,
      "title": "0",
      "manager": 0
    },
    "time": 60,
    "start_time": 1650363318,
    "end_time": 1650363378,
    "gift": {
      "num": 1,
      "gift_id": 12000,
      "gift_name": "醒目留言"
    }
  },
  "roomid": "34348"
}

醒目留言删除 (SUPER_CHAT_MESSAGE_DELETE)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`SUPER_CHAT_MESSAGE_DELETE`
data	obj	消息本体
roomid	num	直播间号

data 对象:

字段	类型	内容	备注
ids	arr	待删除的醒目留言 ID 列表

示例:

查看消息示例:

{
  "cmd": "SUPER_CHAT_MESSAGE_DELETE",
  "data": {
    "ids": [
      3897503
    ]
  },
  "roomid": 23708804
}

送礼 (SEND_GIFT)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`SEND_GIFT`
data	obj	消息本体

data 对象:

字段	类型	内容	备注
action	str	礼物操作，一般为"投喂"
batch_combo_id	str	待调查	有时为空字符串
batch_combo_send	obj	待调查	有时为null
beatId	str	待调查
biz_source	str	待调查
blind_gift		待调查
broadcast_id	num	待调查
coin_type	str	标识金银瓜子礼物对应是否付费?
combo_resources_id	num	待调查
combo_send		待调查
comber_stay_time	num	待调查
combo_total_coin	num	待调查
crit_prob	num	待调查
demarcation	num	待调查
discount_price	num	待调查
dmscore	num	待调查
draw	num	待调查
effect	num	待调查
effect_block	num	待调查
face	str	礼物投喂者的头像URL
face_effect_id	num	待调查
face_effect_type	num	待调查
float_sc_resource_id	num	待调查
giftId	num	礼物ID
giftName	str	礼物名称
giftType	num	待调查
gold	number	待调查
guard_level	num	待调查
is_first	bool	待调查
is_join_receiver	bool	待调查
is_naming	bool	待调查
is_special_batch	num	待调查
magnification	num	待调查
medal_info	obj	礼物投喂者粉丝奖牌信息
name_color	str	待调查
num	num	该次投喂的礼物数量
original_gift_name	str	待调查
price	num	价值
rcost	num	待调查
receive_user_info	obj	礼物接收者信息，一般是主播
remain	num	待调查
rnd	num	礼物发送时的时间戳，以及后面9位未知数字
send_master		待调查
silver	num	待调查
super	num	待调查
super_batch_gift_num	num	待调查
super_gift_num	num	待调查
svga_block	num	待调查
switch	bool	待调查
tag_image	str	待调查
tid	num	礼物发送时的时间戳，以及后面9位未知数字	似乎与rnd字段相同
timestamp	num	礼物发送时的时间戳
top_list		待调查
total_coin	num	实际金银瓜子总价值	不是总等于 num*price
uid	num	礼物投喂者的UID
uname	str	礼物投喂者的名称

data.batch_combo_send 对象:

字段	类型	内容	备注
action	str	礼物操作，一般为"投喂"
batch_combo_id	str	待调查
batch_combo_num	num	待调查
blind_gift		待调查
gift_id	num	待调查
gift_name	str	投喂的礼物名称	待调查
gift_num	num	投喂礼物数量	待调查
send_master		待调查
uid	num	礼物投喂者的UID
uname	str	礼物投喂者的名称

data.medal_info 对象:

字段	类型	内容	备注
anchor_roomid	num	待调查
anchor_uname	str	待调查
guard_level	num	待调查
icon_id	num	待调查
is_lighted	num	待调查
medal_color	num	礼物投喂者的粉丝奖牌颜色	十六进制颜色值转为了十进制表示
medal_border_color	num	礼物投喂者的粉丝奖牌边框颜色	十六进制颜色值的十进制表示
medal_color_end	num	待调查
medal_color_start	num	待调查
medal_level	num	礼物投喂者的粉丝奖牌等级
medal_name	str	礼物投喂者的粉丝奖牌名称
special	str	待调查
target_id	num	待调查

data.receive_user_info 对象:

字段	类型	内容	备注
uid	num	礼物接收者的UID	一般为主播的UID
uname	str	礼物接收者的名称	一般为主播的名称

示例:

查看消息示例:

{
  "cmd": "SEND_GIFT",
  "data": {
    "action": "投喂",
    "batch_combo_id": "batch:gift:combo_id:510149209:36047134:31036:1673622464.8445",
    "batch_combo_send": {
      "action": "投喂",
      "batch_combo_id": "batch:gift:combo_id:510149209:36047134:31036:1673622464.8445",
      "batch_combo_num": 1,
      "blind_gift": null,
      "gift_id": 31036,
      "gift_name": "小花花",
      "gift_num": 1,
      "send_master": null,
      "uid": 510149209,
      "uname": "12138额83121"
    },
    "beatId": "",
    "biz_source": "live",
    "blind_gift": null,
    "broadcast_id": 0,
    "coin_type": "gold",
    "combo_resources_id": 1,
    "combo_send": {
      "action": "投喂",
      "combo_id": "gift:combo_id:510149209:36047134:31036:1673622464.8434",
      "combo_num": 1,
      "gift_id": 31036,
      "gift_name": "小花花",
      "gift_num": 1,
      "send_master": null,
      "uid": 510149209,
      "uname": "12138额83121"
    },
    "combo_stay_time": 3,
    "combo_total_coin": 100,
    "crit_prob": 0,
    "demarcation": 1,
    "discount_price": 100,
    "dmscore": 8,
    "draw": 0,
    "effect": 0,
    "effect_block": 0,
    "face": "https://i1.hdslb.com/bfs/face/fb79103e8b33547023e2010030b6889bba2b49bf.jpg",
    "face_effect_id": 0,
    "face_effect_type": 0,
    "float_sc_resource_id": 0,
    "giftId": 31036,
    "giftName": "小花花",
    "giftType": 0,
    "gold": 0,
    "guard_level": 0,
    "is_first": true,
    "is_join_receiver": false,
    "is_naming": false,
    "is_special_batch": 0,
    "magnification": 1,
    "medal_info": {
      "anchor_roomid": 0,
      "anchor_uname": "",
      "guard_level": 0,
      "icon_id": 0,
      "is_lighted": 0,
      "medal_color": 0,
      "medal_color_border": 0,
      "medal_color_end": 0,
      "medal_color_start": 0,
      "medal_level": 0,
      "medal_name": "",
      "special": "",
      "target_id": 0
    },
    "name_color": "",
    "num": 1,
    "original_gift_name": "",
    "price": 100,
    "rcost": 164536872,
    "receive_user_info": {
      "uid": 36047134,
      "uname": "小霖QL"
    },
    "remain": 0,
    "rnd": "1673622464121900003",
    "send_master": null,
    "silver": 0,
    "super": 0,
    "super_batch_gift_num": 1,
    "super_gift_num": 1,
    "svga_block": 0,
    "switch": true,
    "tag_image": "",
    "tid": "1673622464121900003",
    "timestamp": 1673622464,
    "top_list": null,
    "total_coin": 100,
    "uid": 510149209,
    "uname": "12138额83121"
  }
}

礼物星球点亮 (GIFT_STAR_PROCESS)

注: 主播的礼物星球其一点亮之后

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`GIFT_STAR_PROCESS`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
status	num	待调查
tip	str	点亮礼物星球的消息文本

示例:

查看消息示例：

{
    "cmd": "GIFT_STAR_PROCESS",
    "data": {
        "status": 1,
        "tip": "情书已点亮"
    }
}

礼物连击 (COMBO_SEND)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`COMBO_SEND`
data	obj	信息本体

data 对象:

字段	类型	内容
action	str	礼物操作，一般为"投喂"
batch_combo_id	str	待调查
batch_combo_num	num	连击礼物数量
combo_id	str	待调查
combo_num	str	连击礼物数量
combo_total_coin	num	待调查
dmscore	num	待调查
gift_id	num	待调查
gift_name	str	连击礼物的名称
gift_num	num	0
is_join_receiver	bool	待调查
is_naming	bool	待调查
is_show	num	待调查
medal_info	obj	礼物投喂者的粉丝勋章信息
name_color	str	待调查
r_uname	str	主播的名称
receive_user_info	obj	主播的UID和名称
ruid	num	主播的UID
send_master		待调查
total_num	num	连击礼物数量
uid	num	礼物投喂者的UID
uname	str	礼物投喂者的名称

data.receive_user_info 对象:

字段	类型	内容	备注
uid	number	礼物接收者的UID	一般为主播的UID
uname	string	礼物接收者的名称	一般为主播的名称

示例:

查看消息示例：

{
  "cmd": "COMBO_SEND",
  "data": {
    "action": "投喂",
    "batch_combo_id": "batch:gift:combo_id:3493090830584635:29857468:31036:1673774515.6190",
    "batch_combo_num": 2,
    "combo_id": "gift:combo_id:3493090830584635:29857468:31036:1673774515.6180",
    "combo_num": 2,
    "combo_total_coin": 200,
    "dmscore": 112,
    "gift_id": 31036,
    "gift_name": "小花花",
    "gift_num": 0,
    "is_join_receiver": false,
    "is_naming": false,
    "is_show": 1,
    "medal_info": {
      "anchor_roomid": 0,
      "anchor_uname": "",
      "guard_level": 0,
      "icon_id": 0,
      "is_lighted": 1,
      "medal_color": 6067854,
      "medal_color_border": 6067854,
      "medal_color_end": 6067854,
      "medal_color_start": 6067854,
      "medal_level": 3,
      "medal_name": "爱珞珞",
      "special": "",
      "target_id": 3493076559465366
    },
    "name_color": "",
    "r_uname": "露萌不要雨草",
    "receive_user_info": {
      "uid": 29857468,
      "uname": "露萌不要雨草"
    },
    "ruid": 29857468,
    "send_master": null,
    "total_num": 2,
    "uid": 3493090830584635,
    "uname": "DOC-Neo"
  }
}

特殊礼物 (SPECIAL_GIFT)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`SPECIAL_GIFT`
data	obj	信息本体

data 对象:

以数字为键, JSON Object 为值的表

data['?'] 对象:

字段	类型	内容	备注
action	str	操作?
content	str	内容
hadJoin	num	是否加入?
id	str	?	字符串表示的数字
num	str	数量
storm_gif	str	GIF 动画 URL
time	str	持续时间?

示例:

查看消息示例:

{
  "cmd": "SPECIAL_GIFT",
  "data": {
    "39": {
      "action": "start",
      "content": "可爱即正义~~",
      "hadJoin": 0,
      "id": "3306976431489",
      "num": 1,
      "storm_gif": "http://static.hdslb.com/live-static/live-room/images/gift-section/mobilegift/2/jiezou.gif?2017011901",
      "time": 90
    }
  }
}

通知消息 (NOTICE_MSG)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`NOTICE_MSG`
id	num	待调查
name	str	通知名
full	obj	完整显示信息?
half	obj	半部显示信息?
side	obj	边缘显示信息?
roomid	num	目标直播间短号
real_roomid	num	目标直播间真实ID
msg_common	str	显示的消息内容
msg_self	str	消息内容本身	剔除额外文本
link_url	str	通知消息跳转的URL
msg_type	num	待调查
shield_uid	num	待调查
business_id	str	待调查
scatter	obj	待调查
marquee_id	str	待调查
notice_type	num	待调查

示例:

查看消息示例:

{
  "cmd": "NOTICE_MSG",
  "id": 804,
  "name": "人气榜第一名",
  "full": {
    "head_icon": "https://i0.hdslb.com/bfs/live/f74b09c7fb83123a0dd66c536b6d5b143d271b08.png",
    "tail_icon": "https://i0.hdslb.com/bfs/live/822da481fdaba986d738db5d8fd469ffa95a8fa1.webp",
    "head_icon_fa": "https://i0.hdslb.com/bfs/live/f74b09c7fb83123a0dd66c536b6d5b143d271b08.png",
    "tail_icon_fa": "https://i0.hdslb.com/bfs/live/38cb2a9f1209b16c0f15162b0b553e3b28d9f16f.png",
    "head_icon_fan": 1,
    "tail_icon_fan": 4,
    "background": "#FFE6BD",
    "color": "#9D5412",
    "highlight": "#FF6933",
    "time": 20
  },
  "half": {
    "head_icon": "https://i0.hdslb.com/bfs/live/f74b09c7fb83123a0dd66c536b6d5b143d271b08.png",
    "tail_icon": "https://i0.hdslb.com/bfs/live/822da481fdaba986d738db5d8fd469ffa95a8fa1.webp",
    "background": "#FFE6BD",
    "color": "#9D5412",
    "highlight": "#FF6933",
    "time": 0
  },
  "side": {
    "head_icon": "",
    "background": "",
    "color": "",
    "highlight": "",
    "border": ""
  },
  "roomid": 23919301,
  "real_roomid": 23919301,
  "msg_common": "恭喜主播<%AG超玩会王者荣耀一诺%>荣获上小时人气榜第<%1%>名！点击传送查看精彩内容！",
  "msg_self": "恭喜主播<%AG超玩会王者荣耀一诺%>荣获上小时人气榜第<%1%>名！",
  "link_url": "https://live.bilibili.com/23919301?broadcast_type=0&is_room_feed=1&from=28003&extra_jump_from=28003",
  "msg_type": 1,
  "shield_uid": -1,
  "business_id": "",
  "scatter": {
    "min": 0,
    "max": 0
  },
  "marquee_id": "",
  "notice_type": 0
}

{
  "cmd": "NOTICE_MSG",
  "id": 814,
  "name": "幻影飞船专用",
  "full": {
    "head_icon": "https://i0.hdslb.com/bfs/live/08978f1721200e11328d1f7d6231b21bcca20488.gif",
    "tail_icon": "https://i0.hdslb.com/bfs/live/822da481fdaba986d738db5d8fd469ffa95a8fa1.webp",
    "head_icon_fa": "https://i0.hdslb.com/bfs/live/08978f1721200e11328d1f7d6231b21bcca20488.gif",
    "tail_icon_fa": "https://i0.hdslb.com/bfs/live/38cb2a9f1209b16c0f15162b0b553e3b28d9f16f.png",
    "head_icon_fan": 1,
    "tail_icon_fan": 4,
    "background": "#F09153",
    "color": "#FFFFFF",
    "highlight": "#FFE600",
    "time": 15
  },
  "half": {
    "head_icon": "https://i0.hdslb.com/bfs/live/08978f1721200e11328d1f7d6231b21bcca20488.gif",
    "tail_icon": "",
    "background": "#F09153",
    "color": "#FFFFFFFF",
    "highlight": "#FFE600",
    "time": 15
  },
  "side": {
    "head_icon": "",
    "background": "",
    "color": "",
    "highlight": "",
    "border": ""
  },
  "roomid": 25207004,
  "real_roomid": 25207004,
  "msg_common": "<%咖啡_ミシェル%>投喂<%夜月瓜瓜sukuyi%>1个幻影飞船，向着浩瀚星辰出发！",
  "msg_self": "<%咖啡_ミシェル%>投喂<%夜月瓜瓜sukuyi%>1个幻影飞船，向着浩瀚星辰出发！",
  "link_url": "https://live.bilibili.com/25207004?broadcast_type=0&is_room_feed=1&from=28003&extra_jump_from=28003&live_lottery_type=1",
  "msg_type": 2,
  "shield_uid": -1,
  "business_id": "32356",
  "scatter": {
    "min": 0,
    "max": 0
  },
  "marquee_id": "",
  "notice_type": 0
}

主播准备中 (PREPARING)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`PREPARING`
round	num	轮播状态: 1正在轮播 0未轮播
roomid	num	直播间ID	未知是真实ID还是短号

示例:

查看消息示例:

{
  "cmd": "PREPARING",
  "round": 1,
  "roomid": "8618057"
}

直播开始 (LIVE)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`LIVE`
live_key	str	?
voice_background	str	?
sub_session_key	str	?
live_platform	str	开播平台?
live_model	num	?
live_time	num	开播时间	UNIX 秒级时间戳
roomid	num	直播间号

示例:

查看消息示例:

{
  "cmd": "LIVE",
  "live_key": "234304209915761953",
  "voice_background": "",
  "sub_session_key": "234304209915761953sub_time:1651036923",
  "live_platform": "pc",
  "live_model": 0,
  "live_time": 1651036923,
  "roomid": 23614753
}

主播信息更新 (ROOM_REAL_TIME_MESSAGE_UPDATE)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ROOM_REAL_TIME_MESSAGE_UPDATE`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
roomid	num	直播间ID	未知是真实ID还是短号
fans	num	主播当前粉丝数
red_notice	num	待调查
fans_club	num	主播粉丝团人数

示例:

查看消息示例:

{
  "cmd": "ROOM_REAL_TIME_MESSAGE_UPDATE",
  "data": {
    "roomid": 8618057,
    "fans": 136,
    "red_notice": -1,
    "fans_club": 8
  }
}

直播间高能榜 (ONLINE_RANK_V2)

注: 直播间高能用户数据刷新

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ONLINE_RANK_V2`
data	obj	直播间高能用户数据

data 对象:

字段	类型	内容	备注
list	array	在直播间高能用户中的用户信息
rank_type	str	待调查

data.list[n] 对象:

字段	类型	内容
uid	num	用户 mid
face	str	用户头像 URL
score	str	该用户的贡献值
uname	str	用户名称
rank	num	该用户在高能榜中的排名
guard_level	num	大航海等级?

示例:

查看消息示例：

{
    "cmd": "ONLINE_RANK_V2",
    "data": {
        "list": [
            {
                "uid": 2082621455,
                "face": "https://i2.hdslb.com/bfs/face/9de6050277fa13d830eb97e3453d89843de46a31.jpg",
                "score": "20",
                "uname": "8级萌新_小华",
                "rank": 1,
                "guard_level": 0
            },
            {
                "uid": 50500335,
                "face": "https://i0.hdslb.com/bfs/face/ca722209251478ef0ffb45c3adeafb9dab283c57.jpg",
                "score": "20",
                "uname": "属官一号",
                "rank": 2,
                "guard_level": 0
            },
            {
                "uid": 29857468,
                "face": "https://i1.hdslb.com/bfs/face/7b4ae2e7e950f2dfb2bd969859c813487ce3b64c.jpg",
                "score": "12",
                "uname": "露萌不要雨草",
                "rank": 3,
                "guard_level": 0
            }
        ],
        "rank_type": "gold-rank"
    }
}

直播间高能用户数量 (ONLINE_RANK_COUNT)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ONLINE_RANK_COUNT`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
count	num	直播间高能用户数量

示例:

查看消息示例:

{
  "cmd": "ONLINE_RANK_COUNT",
  "data": {
    "count": 4
  }
}

用户到达直播间高能榜前三名的消息 (ONLINE_RANK_TOP3)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ONLINE_RANK_TOP3`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
dmscore	num	待调查
list	array	消息内容和高能榜排名

data.list[n] 对象:

字段	类型	内容	备注
msg	str	消息内容
rank	num	该用户的高能榜排名

示例:

查看消息示例:

{
  "cmd": "ONLINE_RANK_TOP3",
  "data": {
    "dmscore": 112,
    "list": [
      {
        "msg": "恭喜 <%你干嘛哈哈哎哟%> 成为高能用户",
        "rank": 1
      }
    ]
  }
}

直播间在人气榜的排名改变 (POPULAR_RANK_CHANGED)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`POPULAR_RANK_CHANGED`
data	obj	直播间的人气榜排名信息

data 对象:

字段	类型	内容
uid	num	主播 mid
rank	num	人气榜排名
countdown	num	人气榜下轮结算剩余时长
timestamp	num	触发时的Unix时间戳
cache_key	str	待调查

示例:

查看消息示例：

{
  "cmd": "POPULAR_RANK_CHANGED",
  "data": {
    "uid": 780791,
    "rank": 36,
    "countdown": 1927,
    "timestamp": 1702578474,
    "cache_key": "rank_change:91a4e81ba3034ae894d61e432aa13081"
  }
}

直播间限时热门榜排名改变 (HOT_RANK_CHANGED)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`HOT_RANK_CHANGED`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
rank	num	排名
trend	num	趋势?
countdown	num	剩余时间?
timestamp	num	当前时间?	UNIX 秒级时间戳
web_url	str	排行榜 URL
live_url	str	排行榜 URL
blink_url	str	排行榜 URL
live_link_url	str	排行榜 URL
pc_link_url	str	排行榜 URL
icon	str	图标 URL
area_name	str	分区名称
rank_desc	str	空?

示例:

查看消息示例：

{
  "cmd": "HOT_RANK_CHANGED",
  "data": {
    "rank": 31,
    "trend": 1,
    "countdown": 1440,
    "timestamp": 1651037760,
    "web_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=2&area_id=9&parent_area_id=9&second_area_id=0",
    "live_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=1&area_id=9&parent_area_id=9&second_area_id=0&is_live_half_webview=1&hybrid_rotate_d=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,12,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,12,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "blink_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=3&area_id=9&parent_area_id=9&second_area_id=0&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "live_link_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=5&area_id=9&parent_area_id=9&second_area_id=0&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "pc_link_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=4&is_live_half_webview=1&area_id=9&parent_area_id=9&second_area_id=0&pc_ui=338,465,f4eefa,0",
    "icon": "https://i0.hdslb.com/bfs/live/63217712edb588864b2c714225992e7f46b0b917.png",
    "area_name": "虚拟",
    "rank_desc": ""
  }
}

当前直播间限时热门榜排名改变V2 (HOT_RANK_CHANGED_V2)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`HOT_RANK_CHANGED_V2`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
rank	num	排名
trend	num	趋势?
countdown	num	剩余时间?
timestamp	num	当前时间?	UNIX 秒级时间戳
web_url	str	排行榜 URL
live_url	str	排行榜 URL
blink_url	str	排行榜 URL
live_link_url	str	排行榜 URL
pc_link_url	str	排行榜 URL
icon	str	图标 URL
area_name	str	分区名称
rank_desc	str	排行榜说明

示例:

查看消息示例:

{
  "cmd": "HOT_RANK_CHANGED_V2",
  "data": {
    "rank": 31,
    "trend": 0,
    "countdown": 1440,
    "timestamp": 1651037760,
    "web_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=2&area_id=9&parent_area_id=9&second_area_id=371",
    "live_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=1&area_id=9&parent_area_id=9&second_area_id=371&is_live_half_webview=1&hybrid_rotate_d=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,12,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,12,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "blink_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=3&area_id=9&parent_area_id=9&second_area_id=371&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "live_link_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=5&area_id=9&parent_area_id=9&second_area_id=371&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0",
    "pc_link_url": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=4&is_live_half_webview=1&area_id=9&parent_area_id=9&second_area_id=371&pc_ui=338,465,f4eefa,0",
    "icon": "https://i0.hdslb.com/bfs/live/cb2e160ac4f562b347bb5ae6e635688ebc69580f.png",
    "area_name": "虚拟主播",
    "rank_desc": "虚拟主播top50"
  }
}

限时热门榜上榜信息 (HOT_RANK_SETTLEMENT)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`HOT_RANK_SETTLEMENT`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
area_name	str	分区名称
cache_key	str	?
dm_msg	str	弹幕提示信息
dmscore	num	?
face	str	主播头像 URL
icon	str	图标 URL
rank	num	排名
timestamp	num	时间	UNIX 秒级时间戳
uname	str	主播用户名
url	str	排行榜 URL

示例:

查看消息示例:

{
  "cmd": "HOT_RANK_SETTLEMENT",
  "data": {
    "area_name": "虚拟主播",
    "cache_key": "2f8baf923a6b7df5a045df6c7181984c",
    "dm_msg": "恭喜主播 <% 白黑卡扣 %> 荣登限时热门榜虚拟主播榜top9! 即将获得热门流量推荐哦！",
    "dmscore": 144,
    "face": "http://i0.hdslb.com/bfs/face/ddfcd696213e07884ce227c6ba6d23a007a08c02.jpg",
    "icon": "https://i0.hdslb.com/bfs/live/63217712edb588864b2c714225992e7f46b0b917.png",
    "rank": 9,
    "timestamp": 1651041000,
    "uname": "白黑卡扣",
    "url": "https://live.bilibili.com/p/html/live-app-hotrank/result.html?is_live_half_webview=1&hybrid_half_ui=1,5,250,200,f4eefa,0,30,0,0,0;2,5,250,200,f4eefa,0,30,0,0,0;3,5,250,200,f4eefa,0,30,0,0,0;4,5,250,200,f4eefa,0,30,0,0,0;5,5,250,200,f4eefa,0,30,0,0,0;6,5,250,200,f4eefa,0,30,0,0,0;7,5,250,200,f4eefa,0,30,0,0,0;8,5,250,200,f4eefa,0,30,0,0,0&areaId=9&cache_key=2f8baf923a6b7df5a045df6c7181984c"
  }
}

限时热门榜上榜信息V2 (HOT_RANK_SETTLEMENT_V2)

JSON消息:

基本同限时热门榜上榜信息, 但没有 data.dmscore 字段

示例:

查看消息示例:

{
  "cmd": "HOT_RANK_SETTLEMENT_V2",
  "data": {
    "rank": 9,
    "uname": "白黑卡扣",
    "face": "http://i0.hdslb.com/bfs/face/ddfcd696213e07884ce227c6ba6d23a007a08c02.jpg",
    "timestamp": 1651040700,
    "icon": "https://i0.hdslb.com/bfs/live/cb2e160ac4f562b347bb5ae6e635688ebc69580f.png",
    "area_name": "虚拟主播",
    "url": "https://live.bilibili.com/p/html/live-app-hotrank/result.html?is_live_half_webview=1&hybrid_half_ui=1,5,250,200,f4eefa,0,30,0,0,0;2,5,250,200,f4eefa,0,30,0,0,0;3,5,250,200,f4eefa,0,30,0,0,0;4,5,250,200,f4eefa,0,30,0,0,0;5,5,250,200,f4eefa,0,30,0,0,0;6,5,250,200,f4eefa,0,30,0,0,0;7,5,250,200,f4eefa,0,30,0,0,0;8,5,250,200,f4eefa,0,30,0,0,0&areaId=371&cache_key=693b7b029b66976a399cf4e3485d265a",
    "cache_key": "693b7b029b66976a399cf4e3485d265a",
    "dm_msg": "恭喜主播 <% 白黑卡扣 %> 荣登限时热门榜虚拟主播榜top9! 即将获得热门流量推荐哦！"
  }
}

直播间用户点赞 (LIKE_INFO_V3_CLICK)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`LIKE_INFO_V3_CLICK`
data	obj	信息本体

data 对象:

字段	类型	内容
show_area	num	待调查
msg_type	num	待调查
like_icon	str	点赞图标的URL
uid	num	点赞的用户的UID
like_text	str	点赞文本
uname	str	点赞的用户的名称
uname_color	str	点赞的用户的名称颜色
identities	array	待调查
fans_medal	obj	点赞的用户的粉丝勋章信息
contribution_info	obj	待调查
dmscore	num	待调查

示例:

查看消息示例:

{
  "cmd": "LIKE_INFO_V3_CLICK",
  "data": {
    "show_area": 0,
    "msg_type": 6,
    "like_icon": "https://i0.hdslb.com/bfs/live/23678e3d90402bea6a65251b3e728044c21b1f0f.png",
    "uid": 32174213,
    "like_text": "为主播点赞了",
    "uname": "MeiDngS",
    "uname_color": "",
    "identities": [
      1
    ],
    "fans_medal": {
      "target_id": 0,
      "medal_level": 0,
      "medal_name": "",
      "medal_color": 0,
      "medal_color_start": 12632256,
      "medal_color_end": 12632256,
      "medal_color_border": 12632256,
      "is_lighted": 0,
      "guard_level": 0,
      "special": "",
      "icon_id": 0,
      "anchor_roomid": 0,
      "score": 0
    },
    "contribution_info": {
      "grade": 0
    },
    "dmscore": 20
  }
}

直播间点赞数更新 (LIKE_INFO_V3_UPDATE)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`LIKE_INFO_V3_UPDATE`
data	obj	直播间点赞数

data 对象:

字段	类型	内容	备注
click_count	num	直播间点赞数

示例:

查看消息示例：

{
  "cmd": "LIKE_INFO_V3_UPDATE",
  "data": {
    "click_count": 3227
  }
}

直播间发红包弹幕 (POPULARITY_RED_POCKET_START)

注: 开始抽取红包

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`POPULARITY_RED_POCKET_START`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
lot_id	num	发送的红包的ID
sender_uid	num	发送者的UID
sender_name	str	发送者的名称
sender_face	str	发送者的头像的URL
join_requirement	num	待调查
danmu	str	用户参与红包时自动发送的弹幕内容
current_time	num	服务器发送数据包的Unix时间戳
start_time	num	可以开始抢红包的Unix时间戳
end_time	num	抢红包的结束时间Unix时间戳
last_time	num	红包的持续时间（秒）	start_time - end_time
remove_time	num	待调查
replace_time	num	待调查
lot_status	num	待调查
h5_url	str	红包页面的URL
user_status	num	用户参与状态，但是不知道是哪个用户	1已参与 2未参与
awards	array	红包内包含的礼物的信息
lot_config_id	num	待调查
total_price	num	内含抽取奖品金瓜子总价值	目前红包的 20% 会直接交给主播, 所以 20 电池 (2 CNY) 对应 2000 金瓜子的 80% 是 1600 金瓜子
wait_num	num	待调查

data.awards[n] 对象:

字段	类型	内容
gift_id	num	礼物ID
gift_name	str	礼物名称
gift_pic	str	礼物图标URL
num	num	该礼物的数量

示例:

查看消息示例：

{
  "cmd": "POPULARITY_RED_POCKET_START",
  "data": {
    "lot_id": 2062329,
    "sender_uid": 181851309,
    "sender_name": "毒瘤老肥仔",
    "sender_face": "http://i0.hdslb.com/bfs/face/fed3871b01976ddd35fd3f772ffc2d4949f1391d.jpg",
    "join_requirement": 1,
    "danmu": "老板大气！点点红包抽礼物！",
    "current_time": 1650425344,
    "start_time": 1650425343,
    "end_time": 1650425523,
    "last_time": 180,
    "remove_time": 1650425538,
    "replace_time": 1650425533,
    "lot_status": 1,
    "h5_url": "https://live.bilibili.com/p/html/live-app-red-envelope/popularity.html?is_live_half_webview=1&hybrid_half_ui=1,5,100p,100p,000000,0,50,0,0,1;2,5,100p,100p,000000,0,50,0,0,1;3,5,100p,100p,000000,0,50,0,0,1;4,5,100p,100p,000000,0,50,0,0,1;5,5,100p,100p,000000,0,50,0,0,1;6,5,100p,100p,000000,0,50,0,0,1;7,5,100p,100p,000000,0,50,0,0,1;8,5,100p,100p,000000,0,50,0,0,1&hybrid_rotate_d=1&hybrid_biz=popularityRedPacket&lotteryId=2062329",
    "user_status": 2,
    "awards": [
      {
        "gift_id": 31212,
        "gift_name": "打call",
        "gift_pic": "https://s1.hdslb.com/bfs/live/f75291a0e267425c41e1ce31b5ffd6bfedc6f0b6.png",
        "num": 2
      },
      {
        "gift_id": 31214,
        "gift_name": "牛哇",
        "gift_pic": "https://s1.hdslb.com/bfs/live/b8a38b4bd3be120becddfb92650786f00dffad48.png",
        "num": 3
      },
      {
        "gift_id": 31216,
        "gift_name": "i了i了",
        "gift_pic": "https://s1.hdslb.com/bfs/live/1157a445487b39c0b7368d91b22290c60fa665b2.png",
        "num": 3
      }
    ],
    "lot_config_id": 3,
    "total_price": 1600,
    "wait_num": 0
  }
}

直播间红包 (POPULARITY_RED_POCKET_NEW)

注: 与直播间发红包弹幕不同, 那个是发红包的弹幕信息, 这个则和送礼的信息相似, 但也有前者的一些字段

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`POPULARITY_RED_POCKET_NEW`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
lot_id	num	红包 ID
start_time	num	开抢时间	UNIX 秒级时间戳
current_time	num	当前时间	UNIX 秒级时间戳
wait_num	num	0?
uname	str	发送者用户名
uid	num	发送者的 mid
action	str	礼物操作
num	num	礼物数量
gift_name	str	`红包`
gift_id	num	礼物 ID?
price	num	电池标价
name_color	str	用户名颜色
medal_info	obj	发送者粉丝牌

查看消息示例:

{
  "cmd": "POPULARITY_RED_POCKET_NEW",
  "data": {
    "lot_id": 2062329,
    "start_time": 1650425343,
    "current_time": 1650425343,
    "wait_num": 0,
    "uname": "毒瘤老肥仔",
    "uid": 181851309,
    "action": "送出",
    "num": 1,
    "gift_name": "红包",
    "gift_id": 13000,
    "price": 20,
    "name_color": "#00D1F1",
    "medal_info": {
      "target_id": 11909915,
      "special": "",
      "icon_id": 0,
      "anchor_uname": "",
      "anchor_roomid": 0,
      "medal_level": 22,
      "medal_name": "伊克拉",
      "medal_color": 1725515,
      "medal_color_start": 1725515,
      "medal_color_end": 5414290,
      "medal_color_border": 6809855,
      "is_lighted": 1,
      "guard_level": 3
    }
  }
}

直播间抢到红包的用户 (POPULARITY_RED_POCKET_WINNER_LIST)

注: 红包中奖列表

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`POPULARITY_RED_POCKET_WINNER_LIST`
data	obj	信息本体

data 对象:

字段	类型	内容
lot_id	num	红包 ID
total_num	num	礼物总数
winner_info	array	中奖信息
awards	obj	礼物信息
version	num

data.winner_info 数组:

项	类型	内容
0	array	中奖者 1
……	array	……
n	array	中奖者 (n+1)

data.winner_info[n] 数组:

项	类型	内容
0	num	该抢到红包的用户的 mid
1	str	该抢到红包的用户的名称
2	num	bag_id?
3	num	该用户抢到的礼物的 ID

data.awards 对象:

以礼物 ID 为键, JSON Object 为值的表

data.awards['?'] 对象:

字段	类型	内容
award_type	num	奖品类型?
award_name	str	礼物名称
award_pic	str	礼物图标 URL
award_big_pic	str	礼物大图 URL
award_price	num	礼物价值

查看消息示例:

{
  "cmd": "POPULARITY_RED_POCKET_WINNER_LIST",
  "data": {
    "lot_id": 8445764,
    "total_num": 8,
    "winner_info": [
      [
        38554435,
        "我的0019",
        4581509,
        31212
      ],
      [
        516174930,
        "云来海遛鸟大爷",
        4606389,
        31212
      ]
    ],
    "awards": {
      "31212": {
        "award_type": 1,
        "award_name": "打call",
        "award_pic": "https://s1.hdslb.com/bfs/live/461be640f60788c1d159ec8d6c5d5cf1ef3d1830.png",
        "award_big_pic": "https://i0.hdslb.com/bfs/live/9e6521c57f24c7149c054d265818d4b82059f2ef.png",
        "award_price": 500
      },
      "31214": {
        "award_type": 1,
        "award_name": "牛哇",
        "award_pic": "https://s1.hdslb.com/bfs/live/91ac8e35dd93a7196325f1e2052356e71d135afb.png",
        "award_big_pic": "https://i0.hdslb.com/bfs/live/3b74c117b4f265edcea261bc5608a58d3a7c300a.png",
        "award_price": 100
      },
      "31216": {
        "award_type": 1,
        "award_name": "i了i了",
        "award_pic": "https://s1.hdslb.com/bfs/live/1157a445487b39c0b7368d91b22290c60fa665b2.png",
        "award_big_pic": "https://i0.hdslb.com/bfs/live/cfb9c3d9bdd2c25c95b7d859ebaa590ca9362adb.png",
        "award_price": 100
      }
    },
    "version": 1
  }
}

直播间看过人数 (WATCHED_CHANGE)

注: 当前直播历史观众数量, 可替代人气

正文:

数据包的正文, 前19字节的信息未知:

00000001: 8b38 8000 0000 7200 1000 0000 0000 0500  .8....r.........
00000002: 0000 00                                  ...

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`WATCHED_CHANGE`
data	obj	信息本体

data 对象:

字段	类型	内容
num	num	看过人数
text_small	str	显示文字 (小)
text_large	str	显示文字 (大)

示例:

查看消息示例:

{
  "cmd": "WATCHED_CHANGE",
  "data": {
    "num": 17903,
    "text_small": "1.7万",
    "text_large": "1.7万人看过"
  }
}

用户进场特效 (ENTRY_EFFECT)

注: 有进场特效的用户进入直播间

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ENTRY_EFFECT`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
id	num	?
uid	num	进场用户 mid
target_id	num	主播 mid?
mock_effect	num	?
face	str	进场用户头像 URL
privilege_type	num	?
copy_writing	str	进场欢迎文本
copy_color	str	进场欢迎文本颜色	16 进制
highlight_color	str	高亮颜色?	16 进制
priority	num	优先级?
basemap_url	str	进场特效背景 URL	APP 端
show_avatar	num	是否显示用户头像	1: 显示 0: 不显示
web_basemap_url	str	进场特效背景 URL	网页端
web_effective_time	num	进场特效生存时间	网页端
web_effect_close	num	?
web_close_time	num	?
business	num	?
copy_writing_v2	str	进场欢迎文本	APP 端?
icon_list	array	空?
max_delay_time	num	最大等待时间?
trigger_time	num	触发时间戳	UNIX 纳秒时间戳
identities	num	标识符?
effect_silent_time	num	?
effective_time_new	num	?
web_dynamic_url_webp	str	?
web_dynamic_url_apng	str	?
mobile_dynamic_url_webp	str	?

示例:

查看消息示例：

{
  "cmd": "ENTRY_EFFECT",
  "data": {
    "id": 4,
    "uid": 489893482,
    "target_id": 27717502,
    "mock_effect": 0,
    "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg",
    "privilege_type": 3,
    "copy_writing": "欢迎舰长 <%天使雨晰%> 进入直播间",
    "copy_color": "#ffffff",
    "highlight_color": "#E6FF00",
    "priority": 1,
    "basemap_url": "https://i0.hdslb.com/bfs/live/mlive/11a6e8eb061c3e715d0a6a2ac0ddea2faa15c15e.png",
    "show_avatar": 1,
    "effective_time": 2,
    "web_basemap_url": "https://i0.hdslb.com/bfs/live/mlive/11a6e8eb061c3e715d0a6a2ac0ddea2faa15c15e.png",
    "web_effective_time": 2,
    "web_effect_close": 0,
    "web_close_time": 0,
    "business": 1,
    "copy_writing_v2": "欢迎舰长 <%天使雨晰%> 进入直播间",
    "icon_list": [],
    "max_delay_time": 7,
    "trigger_time": 1673625604373633300,
    "identities": 6,
    "effect_silent_time": 0,
    "effective_time_new": 0,
    "web_dynamic_url_webp": "",
    "web_dynamic_url_apng": "",
    "mobile_dynamic_url_webp": ""
  }
}

全屏特效 (FULL_SCREEN_SPECIAL_EFFECT)

示例:

查看响应示例:

{
  "cmd": "FULL_SCREEN_SPECIAL_EFFECT",
  "data": {
    "type": 2,
    "ids": [
      514
    ],
    "queue": 2,
    "platform_in": [
      1,
      2
    ]
  }
}

直播间在所属分区的排名改变 (AREA_RANK_CHANGED)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`AREA_RANK_CHANGED`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
conf_id	num	配置 ID?
rank_name	str	排行榜名称
uid	num	主播 mid
rank	num	直播间在分区的排名	没有上榜则为 0
icon_url_blue	str	蓝色排名图标 URL
icon_url_pink	str	粉色排名图标 URL
icon_url_grey	str	灰色排名图标 URL
action_type	num	?
timestamp	num	当前时间	UNIX 秒级时间戳
msg_id	str	?	一串 UUID
jump_url_link	str	排行榜跳转链接
jump_url_pc	str	排行榜跳转链接
jump_url_pink	str	排行榜跳转链接
jump_url_web	str	排行榜跳转链接

示例:

查看消息示例:

{
  "cmd": "AREA_RANK_CHANGED",
  "data": {
    "conf_id": 23,
    "rank_name": "手游航海",
    "uid": 27717502,
    "rank": 4,
    "icon_url_blue": "https://i0.hdslb.com/bfs/live/18e2990a546d33368200f9058f3d9dbc4038eb5c.png",
    "icon_url_pink": "https://i0.hdslb.com/bfs/live/a6c490c36e88c7b191a04883a5ec15aed187a8f7.png",
    "icon_url_grey": "https://i0.hdslb.com/bfs/live/cb7444b1faf1d785df6265bfdc1fcfc993419b76.png",
    "action_type": 1,
    "timestamp": 1673625610,
    "msg_id": "e93c7860-b901-41ca-aad8-fe538a5fac9c",
    "jump_url_link": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=3&ruid=27717502&conf_id=23&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0#/area-rank",
    "jump_url_pc": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=4&ruid=27717502&conf_id=23&pc_ui=338,465,f4eefa,0#/area-rank",
    "jump_url_pink": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=1&ruid=27717502&conf_id=23&is_live_half_webview=1&hybrid_rotate_d=1&is_cling_player=1&hybrid_half_ui=1,3,100p,70p,f4eefa,0,30,100,0,0;2,2,375,100p,f4eefa,0,30,100,0,0;3,3,100p,70p,f4eefa,0,30,100,0,0;4,2,375,100p,f4eefa,0,30,100,0,0;5,3,100p,70p,f4eefa,0,30,100,0,0;6,3,100p,70p,f4eefa,0,30,100,0,0;7,3,100p,70p,f4eefa,0,30,100,0,0;8,3,100p,70p,f4eefa,0,30,100,0,0#/area-rank",
    "jump_url_web": "https://live.bilibili.com/p/html/live-app-hotrank/index.html?clientType=2&ruid=27717502&conf_id=23#/area-rank"
  }
}

广播通知弹幕信息 (COMMON_NOTICE_DANMAKU)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`COMMON_NOTICE_DANMAKU`
data	obj	信息本体

data 对象:

字段	类型	内容
biz_id	num	待调查
content_segments	array	文本分段
danmaku_style	obj	文本样式信息
danmaku_url	str	待调查
dmscore	num	待调查
terminals	array	待调查

data.content_segments[n] 数组中的对象

字段	类型	内容	备注
font_color	str	text 字段的十六进制颜色值
font_color_dark	str	text 字段的十六进制颜色值	APP端设置为深色模式时使用
text	str	文本
type	num	待调查

data.danmaku_style 对象:

字段	类型	内容	备注
background_color	str	文本背景颜色的十六进制颜色值
background_color_dark	str	文本背景颜色的十六进制颜色值	APP端设置为深色模式时使用

示例:

查看消息示例:

{
  "cmd": "COMMON_NOTICE_DANMAKU",
  "data": {
    "content_segments": [
      {
        "font_color": "#FB7299",
        "text": "春日限时任务：任务即将结束，抓紧完成获取3元红包奖励吧！未完成任务进度将重置",
        "type": 1
      }
    ],
    "dmscore": 144,
    "terminals": [
      1,
      2,
      3,
      4,
      5
    ]
  }
}

{
  "cmd": "COMMON_NOTICE_DANMAKU",
  "data": {
    "biz_id": 0,
    "content_segments": [
      {
        "font_color": "#CCCCCC",
        "font_color_dark": "#CCCCCC",
        "text": "恭喜主播 时雨ioo ",
        "type": 1
      },
      {
        "font_color": "#F494AF",
        "font_color_dark": "#F494AF",
        "text": "成为手游航海当前第5名",
        "type": 1
      }
    ],
    "danmaku_style": {
      "background_color": null,
      "background_color_dark": null
    },
    "danmaku_uri": "",
    "dmscore": 144,
    "terminals": [
      1,
      2,
      3
    ]
  }
}

直播间信息更改 (ROOM_CHANGE)

注: 例如直播间标题更改、直播间分区更改

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ROOM_CHANGE`
data	obj

data 对象:

字段	类型	内容
title	str	直播间标题
area_id	num	当前直播间所属分区的ID
parent_area_id	num	待调查
area_name	str	当前直播间所属分区的名称
parent_area_name	str	待调查
live_key	str	待调查
sub_session_key	str	待调查

示例:

查看消息示例:

{
    "cmd": "ROOM_CHANGE",
    "data": {
        "title": "开始白给CS",
        "area_id": 371,
        "parent_area_id": 9,
        "area_name": "虚拟主播",
        "parent_area_name": "虚拟主播",
        "live_key": "320830629635915849",
        "sub_session_key": "320830629635915849sub_time:1673690546"
    }
}

醒目留言按钮 (SUPER_CHAT_ENTRANCE)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`SUPER_CHAT_ENTRANCE`
data	obj	醒目留言按钮的信息
roomid	num	直播间ID	未知是短号还是真实ID

data 对象:

字段	类型	内容
status	num	待调查
jump_url	str	按下“醒目留言”按钮后弹出小窗的页面URL
icon	str	“醒目留言”按钮图标的URL
broadcast_type	num	待调查

示例:

查看消息示例:

{
    "cmd": "SUPER_CHAT_ENTRANCE",
    "data": {
        "status": 1,
        "jump_url": "https://live.bilibili.com/p/html/live-app-superchat2/index.html?is_live_half_webview=1&hybrid_half_ui=1,3,100p,70p,ffffff,0,30,100;2,2,375,100p,ffffff,0,30,100;3,3,100p,70p,ffffff,0,30,100;4,2,375,100p,ffffff,0,30,100;5,3,100p,60p,ffffff,0,30,100;6,3,100p,60p,ffffff,0,30,100;7,3,100p,60p,ffffff,0,30,100",
        "icon": "https://i0.hdslb.com/bfs/live/0a9ebd72c76e9cbede9547386dd453475d4af6fe.png",
        "broadcast_type": 1
    },
    "roomid": "8618057"
}

顶部横幅 (WIDGET_BANNER)

注: 网页端在直播间标题下面的横幅, 例如限时任务等

JSON消息:

字段	类型	内容	备注
cmd	str	`WIDGET_BANNER`
data	obj	横幅信息

data 对象:

字段	类型	内容	备注
timestamp	num	服务器发送数据包时的Unix时间戳
widget_list	obj	横幅信息	待调查

data.widget_list 对象:

以横幅 ID 为键, JSON Object 为值的表

data.widget_list['?'] 对象:

字段	类型	内容
id	num	横幅ID
title	str	待调查
cover	str	待调查
web_cover	str	待调查
tip_text	str	待调查
tip_text_color	str	待调查
tip_bottom_color	str	待调查
jump_url	str	点击横幅后出现小窗的页面的URL
url	str	待调查
stay_time	num	待调查
site	num	待调查
platform_in	array	待调查
type	num	待调查
band_id	num	待调查
sub_key	str	待调查
sub_data	str	横幅数据
is_add	bool	待调查

示例:

查看消息示例:

{
  "cmd": "WIDGET_BANNER",
  "data": {
    "timestamp": 1673684868,
    "widget_list": {
      "308": {
        "id": 308,
        "title": "一月限时任务",
        "cover": "",
        "web_cover": "",
        "tip_text": "限时任务",
        "tip_text_color": "",
        "tip_bottom_color": "",
        "jump_url": "https://live.bilibili.com/activity/live-activity-battle/index.html?app_name=time_limited_task_jan_2023&is_live_half_webview=1&hybrid_rotate_d=1&hybrid_half_ui=1,3,100p,70p,0,0,0,0,12,0;2,2,375,100p,0,0,0,0,12,0;3,3,100p,70p,0,0,0,0,12,0;4,2,375,100p,0,0,0,0,12,0;5,3,100p,70p,0,0,0,0,12,0;6,3,100p,70p,0,0,0,0,12,0;7,3,100p,70p,0,0,0,0,12,0;8,3,100p,70p,0,0,0,0,12,0&room_id=8618057&uid=29857468#/",
        "url": "",
        "stay_time": 5,
        "site": 1,
        "platform_in": [
          "live",
          "blink",
          "live_link",
          "web",
          "pc_link"
        ],
        "type": 1,
        "band_id": 101558,
        "sub_key": "",
        "sub_data": "%7B%22task_status%22%3A0%2C%22current_val%22%3A10%2C%22target_val%22%3A1200%2C%22timeout%22%3A1673687024%2C%22reward_price%22%3A8%2C%22reward_type%22%3A1%7D",
        "is_add": true
      }
    }
  }
}

礼物心愿单进度 (WIDGET_WISH_LIST)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`WIDGET_WISH_LIST`
data	obj	信息本体

data 对象:

字段	类型	内容
wish	array	礼物心愿单信息
wish_status	num	?
sid	num	?
wish_status_info	array	?

示例:

查看消息示例:

{
  "cmd": "WIDGET_WISH_LIST",
  "data": {
    "wish": [
      {
        "type": 3,
        "gift_id": 10003,
        "gift_name": "舰长",
        "gift_img": "https://i0.hdslb.com/bfs/live/f1be2a2d5b227ce72641de1ad64bcc7f9e4111c3.png",
        "gift_price": 198000,
        "target_num": 5,
        "current_num": 0
      },
      {
        "type": 2,
        "gift_id": 3,
        "gift_name": "B坷垃",
        "gift_img": "https://s1.hdslb.com/bfs/live/cc8bfcbc24c8b65937f62ce0d16b31ab987dce47.png",
        "gift_price": 9900,
        "target_num": 5,
        "current_num": 0
      },
      {
        "type": 2,
        "gift_id": 31039,
        "gift_name": "牛哇牛哇",
        "gift_img": "https://s1.hdslb.com/bfs/live/b8a38b4bd3be120becddfb92650786f00dffad48.png",
        "gift_price": 100,
        "target_num": 10,
        "current_num": 0
      }
    ],
    "wish_status": 1,
    "sid": 477,
    "wish_status_info": [
      {
        "wish_status_msg": "设定心 愿",
        "wish_status_img": "https://i0.hdslb.com/bfs/live/38f82bac32794e79776f7371269453652bd58a87.png",
        "wish_status": 0
      },
      {
        "wish_status_msg": "达成",
        "wish_status_img": "https://i0.hdslb.com/bfs/live/1dae635924437239fc69e561a1a9467508521249.png",
        "wish_status": 2
      },
      {
        "wish_status_msg": "收集失败",
        "wish_status_img": "https://i0.hdslb.com/bfs/live/3bbd30fdd32d085cc90e9ccd98c65a886dca9a8f.png",
        "wish_status": 3
      }
    ],
    "wish_name": "心愿"
  }
}

下播的直播间 (STOP_LIVE_ROOM_LIST)

注: 估计是更新关注的主播直播状态的

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`STOP_LIVE_ROOM_LIST`
data	obj	信息本体

data 对象:

字段	类型	内容	备注
room_id_list	array	下播的直播间ID

data.room_id_list 数组:

项	类型	内容
0	num	第 1 个下播的直播间 ID
1	num	第 2 个下播的直播间 ID
……	num	……
n	num	第 (n+1) 个下播的直播间 ID

查看消息示例:

{
  "cmd": "STOP_LIVE_ROOM_LIST",
  "data": {
    "room_id_list": [
      14507570, 23963084, 24370437, 24380902, 24889494,
      22735090, 24268758, 24668544,    38325, 24762357,
       3222966,  6684395, 24199566, 24864470, 10224194,
      14953052,  6198131,   898214, 10412034, 22506883,
      23932516,  6768714, 24392281,  1799500, 22392518,
      22976729, 21557043, 24896092, 11718936, 21612704,
      21778117, 24145539, 23178318, 23575414, 24842462,
      22245210, 24895499,  3133873,  1298898, 22175308,
       3600684,  2053035,   270652, 24877480,  3854611,
      21512488, 24393104, 24756457,  4630683,  6955412,
      23199465,  2880481, 23868339,   717791, 24068307,
      24875243, 22777819, 24896061, 24619665
    ]
  }
}

系统信息 (SYS_MSG)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`SYS_MSG`
msg	str	提示信息
url	str	跳转 URL

示例:

查看消息示例:

{
  "cmd": "SYS_MSG",
  "msg": "争夺开启，时间周五20点至周日20点，逾期不候哟！",
  "url": ""
}

警告 (WARNING)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`WARNING`
msg	str	警告信息
roomid	num	直播间 ID

示例:

查看消息示例:

{
  "cmd": "WARNING",
  "msg": "图片内容不适宜，请立即调整",
  "roomid": 22195814
}

切断 (CUT_OFF)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`CUT_OFF`
msg	str	切断原因
roomid	num	直播间 ID

示例:

查看消息示例:

{
  "cmd": "CUT_OFF",
  "msg": "违反直播言论规范，请立即调整",
  "roomid": 23993070
}

直播间背景图片修改 (CHANGE_ROOM_INFO)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`CHANGE_ROOM_INFO`
background	str	背景图 URL
roomid	num	直播间 ID

示例:

查看消息示例:

{
  "cmd": "CHANGE_ROOM_INFO",
  "background": "https://i0.hdslb.com/bfs/live/2388faed3728f3396052273ad4c3c9af21c411fc.jpg",
  "roomid": 23993070
}

直播间皮肤变更 (ROOM_SKIN_MSG)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ROOM_SKIN_MSG`
skin_id	num	皮肤 ID
status	num	状态?
end_time	num	皮肤结束时间?	UNIX 秒级时间戳
current_time	num	当前时间	UNIX 秒级时间戳
only_local	bool	仅在本地显示?
scatter	obj	?
skin_config	obj	皮肤配置

示例:

查看消息示例:

{
  "cmd": "ROOM_SKIN_MSG",
  "skin_id": 353,
  "status": 1,
  "end_time": 1652620669,
  "current_time": 1652015870,
  "only_local": false,
  "scatter": {
    "min": 1,
    "max": 200
  },
  "skin_config": {
    "android": {
      "1": {
        "zip": "https://i0.hdslb.com/bfs/live/fab943a5d7eeb871ecf06413283d17536e67ab91.zip",
        "md5": "011EBB3E14192212FD50852245DC74FA"
      }
    },
    "ios": {
      "1": {
        "zip": "https://i0.hdslb.com/bfs/live/e7d8768dcb3975d82d794fe6b39756317916a7fe.zip",
        "md5": "B1223577FE9C5C248EC1326CDACF8379"
      }
    },
    "ipad": {
      "1": {
        "zip": "https://i0.hdslb.com/bfs/live/0856e17be073d75b70098609ae26572ba1534605.zip",
        "md5": "481AE75FFD0E0DE91EAFB5B6E0F8936B"
      }
    },
    "web": {
      "1": {
        "zip": "https://i0.hdslb.com/bfs/live/0b3770980e600f23629c8445fd211d4a12ec4b6f.zip",
        "md5": "8F98F79F02DEFE8B69EE2F6DE7416DFF",
        "platform": "web",
        "version": "1",
        "headInfoBgPic": "https://i0.hdslb.com/bfs/live/d293e69b70af34df0fef086a86552b1761a33a75.jpg",
        "giftControlBgPic": "https://i0.hdslb.com/bfs/live/1a124c5547c784f41dc3d7f65f446c56c4cbb73e.jpg",
        "rankListBgPic": "https://i0.hdslb.com/bfs/live/af8580a956d0eac6ea1d2cc97ea743d435a86874.jpg",
        "mainText": "#FFffffff",
        "normalText": "#FFffffff",
        "highlightContent": "#FFffd119",
        "border": "#FFaec2ff",
        "buttonText": "#FF123ab2"
      }
    }
  }
}

开启等级禁言 (ROOM_SILENT_ON)

JSON消息:

根对象:

字段	类型	内容	备注
data	obj	信息本体
cmd	str	`ROOM_SILENT_ON`

data 对象:

字段	类型	内容	备注
type	str	类型?
level	num	等级?
second	num	时间?	UNIX 秒级时间戳

示例:

查看消息示例:

{
  "data": {
    "type": "member",
    "level": 1,
    "second": 1651000426
  },
  "cmd": "ROOM_SILENT_ON"
}

关闭等级禁言 (ROOM_SILENT_OFF)

JSON消息:

根对象:

字段	类型	内容	备注
data	obj	信息本体
cmd	str	`ROOM_SILENT_OFF`

data 对象:

字段	类型	内容
type	str	空
level	num	0
second	num	0

示例:

查看消息示例:

{
  "data": {
    "type": "",
    "level": 0,
    "second": 0
  },
  "cmd": "ROOM_SILENT_OFF"
}

指定观众禁言 (ROOM_BLOCK_MSG)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`ROOM_BLOCK_MSG`
data	obj	详细信息
uid	num	禁言用户 mid
uname	str	禁言用户名

data 对象:

字段	类型	内容
dmscore	num	弹幕分数?
operator	num	操作者?
uid	num	禁言用户 mid
uname	str	禁言用户名

示例:

查看消息示例:

{
  "cmd": "ROOM_BLOCK_MSG",
  "data": {
    "dmscore": 30,
    "operator": 2,
    "uid": 37903025,
    "uname": "玉麟珑"
  },
  "uid": "37903025",
  "uname": "玉麟珑"
}

房管列表 (ROOM_ADMINS)

JSON消息:

根对象:

字段	类型	内容	备注
cmd	str	`ROOM_ADMINS`
uids	array	房管 mid 列表

示例:

查看消息示例:

{
  cmd: "ROOM_ADMINS",
  uids: [ 898424, 384203692, 1309513, 30816752, 23931549, 223134 ]
}

设立房管 (room_admin_entrance)

注: 此处 cmd 内容为小写

JSON消息:

根对象:

字段	类型	内容
cmd	str	`room_admin_entrance`
dmscore	num	弹幕分数?
level	num	等级?
msg	str	提示信息
uid	num	用户 mid

示例:

查看消息示例:

{
  "cmd": "room_admin_entrance",
  "dmscore": 45,
  "level": 1,
  "msg": "系统提示：你已被主播设为房管",
  "uid": 223134
}

撤销房管 (ROOM_ADMIN_REVOKE)

JSON消息:

根对象:

字段	类型	内容
cmd	str	`ROOM_ADMIN_REVOKE`
msg	str	提示信息
uid	num	用户 mid

示例:

查看消息示例:

{
  "cmd": "ROOM_ADMIN_REVOKE",
  "msg": "撤销房管",
  "uid": 6791627
}

天选时刻合法检查 (ANCHOR_LOT_CHECKSTATUS)

示例:

查看响应示例:

{
  "cmd": "ANCHOR_LOT_CHECKSTATUS",
  "data": {
    "id": 2553641,
    "reject_reason": "由于奖品格式不合格,请仔细检查后再提交哦",
    "status": 5,
    "uid": 1827176970
  }
}

天选时刻开始 (ANCHOR_LOT_START)

示例:

查看响应示例:

{
  "cmd": "ANCHOR_LOT_START",
  "data": {
    "asset_icon": "https://i0.hdslb.com/bfs/live/627ee2d9e71c682810e7dc4400d5ae2713442c02.png",
    "award_image": "",
    "award_name": "艺术头像绘制",
    "award_num": 1,
    "cur_gift_num": 0,
    "current_time": 1651037946,
    "danmu": "卡宝下午好",
    "gift_id": 3,
    "gift_name": "B坷垃",
    "gift_num": 1,
    "gift_price": 9900,
    "goaway_time": 180,
    "goods_id": 15,
    "id": 2553648,
    "is_broadcast": 1,
    "join_type": 1,
    "lot_status": 0,
    "max_time": 600,
    "require_text": "当前主播粉丝勋章至少1级",
    "require_type": 2,
    "require_value": 1,
    "room_id": 23614753,
    "send_gift_ensure": 0,
    "show_panel": 1,
    "start_dont_popup": 0,
    "status": 1,
    "time": 599,
    "url": "https://live.bilibili.com/p/html/live-lottery/anchor-join.html?is_live_half_webview=1&hybrid_biz=live-lottery-anchor&hybrid_half_ui=1,5,100p,100p,000000,0,30,0,0,1;2,5,100p,100p,000000,0,30,0,0,1;3,5,100p,100p,000000,0,30,0,0,1;4,5,100p,100p,000000,0,30,0,0,1;5,5,100p,100p,000000,0,30,0,0,1;6,5,100p,100p,000000,0,30,0,0,1;7,5,100p,100p,000000,0,30,0,0,1;8,5,100p,100p,000000,0,30,0,0,1",
    "web_url": "https://live.bilibili.com/p/html/live-lottery/anchor-join.html"
  }
}

天选时刻结束 (ANCHOR_LOT_END)

查看消息示例:

{
  "cmd": "ANCHOR_LOT_END",
  "data": {
    "id": 2553648
  }
}

天选时刻中奖者 (ANCHOR_LOT_AWARD)

查看消息示例:

{
  "cmd": "ANCHOR_LOT_AWARD",
  "data": {
    "award_dont_popup": 1,
    "award_image": "",
    "award_name": "艺术头像绘制",
    "award_num": 1,
    "award_users": [
      {
        "uid": 8318700,
        "uname": "桥下念喬",
        "face": "http://i0.hdslb.com/bfs/face/dfde2ffc6286c2c5189592cc84fd70bcf977b143.jpg",
        "level": 21,
        "color": 5805790
      }
    ],
    "id": 2553648,
    "lot_status": 2,
    "url": "https://live.bilibili.com/p/html/live-lottery/anchor-join.html?is_live_half_webview=1&hybrid_biz=live-lottery-anchor&hybrid_half_ui=1,5,100p,100p,000000,0,30,0,0,1;2,5,100p,100p,000000,0,30,0,0,1;3,5,100p,100p,000000,0,30,0,0,1;4,5,100p,100p,000000,0,30,0,0,1;5,5,100p,100p,000000,0,30,0,0,1;6,5,100p,100p,000000,0,30,0,0,1;7,5,100p,100p,000000,0,30,0,0,1;8,5,100p,100p,000000,0,30,0,0,1",
    "web_url": "https://live.bilibili.com/p/html/live-lottery/anchor-join.html"
  }
}

邀请视频连线 (VIDEO_CONNECTION_JOIN_START)

示例:

查看消息示例:

{
  "cmd": "VIDEO_CONNECTION_JOIN_START",
  "data": {
    "status": 1,
    "invited_uid": 351686170,
    "channel_id": "72057594038132685",
    "invited_uname": "小妹睡不醒",
    "invited_face": "http://i1.hdslb.com/bfs/face/828562203e620f711fb4c786f05996357857ed4d.jpg",
    "start_at": 1651237440,
    "current_time": 1651237440
  },
  "roomid": 12401854
}

视频连线信息 (VIDEO_CONNECTION_MSG)

示例:

查看消息示例:

{
  "cmd": "VIDEO_CONNECTION_MSG",
  "data": {
    "channel_id": "72057594038132685",
    "current_time": 1651237440,
    "dmscore": 4,
    "toast": "主播发起了视频连线"
  }
}

结束视频连线 (VIDEO_CONNECTION_JOIN_END)

示例:

查看消息示例:

{
  "cmd": "VIDEO_CONNECTION_JOIN_END",
  "data": {
    "channel_id": "72057594038132685",
    "start_at": 1651238384,
    "toast": "主播 结束了与小妹睡不醒的连线.",
    "current_time": 1651238384
  },
  "roomid": 22195814
}

重连直播间? (REENTER_LIVE_ROOM)

查看消息示例:

{
  "cmd": "REENTER_LIVE_ROOM",
  "data": {
    "room_id": 22195814,
    "request_random_sec_range": 10,
    "reason": 1
  },
  "roomid": 22195814
}

??? (PLAY_TOGETHER)

示例:

查看消息示例:

{
  "cmd": "PLAY_TOGETHER",
  "data": {
    "ruid": 29857468,
    "roomid": 8618057,
    "action": "switch_off",
    "uid": 0,
    "timestamp": 1673690546,
    "message": "",
    "message_type": 0,
    "jump_url": "",
    "web_url": "",
    "apply_number": 0,
    "refresh_tool": false,
    "cur_fleet_num": 0,
    "max_fleet_num": 0
  }
}

{
  "cmd": "PLAY_TOGETHER",
  "data": {
    "ruid": 29857468,
    "roomid": 8618057,
    "action": "switch_off",
    "uid": 0,
    "timestamp": 1673690549,
    "message": "系统提示：主播已切换分区",
    "message_type": 3,
    "jump_url": "",
    "web_url": "",
    "apply_number": 0,
    "refresh_tool": true,
    "cur_fleet_num": 0,
    "max_fleet_num": 0
  }
}

Files

message_stream.md

Latest commit

History

message_stream.md

File metadata and controls

直播间信息流

获取信息流认证秘钥

数据包格式

数据包

认证包

认证包回复

心跳包

心跳包回复 (人气值)

普通包

弹幕 (DANMU_MSG)

连续弹幕消息 (DM_INTERACTION)

进场或关注消息 (INTERACT_WORD)

上舰通知 (GUARD_BUY)

用户庆祝消息 (USER_TOAST_MSG)

醒目留言 (SUPER_CHAT_MESSAGE)

醒目留言日语 (SUPER_CHAT_MESSAGE_JPN)

醒目留言删除 (SUPER_CHAT_MESSAGE_DELETE)

送礼 (SEND_GIFT)

礼物星球点亮 (GIFT_STAR_PROCESS)

礼物连击 (COMBO_SEND)

特殊礼物 (SPECIAL_GIFT)

通知消息 (NOTICE_MSG)

主播准备中 (PREPARING)

直播开始 (LIVE)

主播信息更新 (ROOM_REAL_TIME_MESSAGE_UPDATE)

直播间高能榜 (ONLINE_RANK_V2)

直播间高能用户数量 (ONLINE_RANK_COUNT)

用户到达直播间高能榜前三名的消息 (ONLINE_RANK_TOP3)

直播间在人气榜的排名改变 (POPULAR_RANK_CHANGED)

直播间限时热门榜排名改变 (HOT_RANK_CHANGED)

当前直播间限时热门榜排名改变V2 (HOT_RANK_CHANGED_V2)

限时热门榜上榜信息 (HOT_RANK_SETTLEMENT)

限时热门榜上榜信息V2 (HOT_RANK_SETTLEMENT_V2)

直播间用户点赞 (LIKE_INFO_V3_CLICK)

直播间点赞数更新 (LIKE_INFO_V3_UPDATE)

直播间发红包弹幕 (POPULARITY_RED_POCKET_START)

直播间红包 (POPULARITY_RED_POCKET_NEW)

直播间抢到红包的用户 (POPULARITY_RED_POCKET_WINNER_LIST)

直播间看过人数 (WATCHED_CHANGE)

用户进场特效 (ENTRY_EFFECT)

全屏特效 (FULL_SCREEN_SPECIAL_EFFECT)

直播间在所属分区的排名改变 (AREA_RANK_CHANGED)

广播通知弹幕信息 (COMMON_NOTICE_DANMAKU)

直播间信息更改 (ROOM_CHANGE)

醒目留言按钮 (SUPER_CHAT_ENTRANCE)

顶部横幅 (WIDGET_BANNER)

礼物心愿单进度 (WIDGET_WISH_LIST)

下播的直播间 (STOP_LIVE_ROOM_LIST)

系统信息 (SYS_MSG)

警告 (WARNING)

切断 (CUT_OFF)

直播间背景图片修改 (CHANGE_ROOM_INFO)

直播间皮肤变更 (ROOM_SKIN_MSG)

开启等级禁言 (ROOM_SILENT_ON)

关闭等级禁言 (ROOM_SILENT_OFF)

指定观众禁言 (ROOM_BLOCK_MSG)

房管列表 (ROOM_ADMINS)

设立房管 (room_admin_entrance)

撤销房管 (ROOM_ADMIN_REVOKE)

天选时刻合法检查 (ANCHOR_LOT_CHECKSTATUS)

天选时刻开始 (ANCHOR_LOT_START)

天选时刻结束 (ANCHOR_LOT_END)

天选时刻中奖者 (ANCHOR_LOT_AWARD)

邀请视频连线 (VIDEO_CONNECTION_JOIN_START)

视频连线信息 (VIDEO_CONNECTION_MSG)

结束视频连线 (VIDEO_CONNECTION_JOIN_END)

重连直播间? (REENTER_LIVE_ROOM)

??? (PLAY_TOGETHER)