返回提交历史
Modified
docs/live/message_stream.md
+184
-0
XFEstudio/bilibili-API-collect
增加直播流数据包种类解释 (#906)
* 添加人气榜排名更新 * 添加USER_TOAST_MSG数据包 * 增加 DM_INTERACTION 数据包内容
8951dce
代码差异
1 个文件
+184
-0
@@ -446,6 +446,73 @@ json格式
446
446
```
447
447
</details>
448
448
449
450
#### 连续弹幕消息
451
452
连续多条相同弹幕时触发
453
454
json格式
455
456
| 字段 | 类型 | 内容 | 备注 |
457
| ---- | ---- | ------ | --------- |
458
| cmd | str | "DM_INTERACTION" | 如果是进入直播间或关注消息，内容则是"INTERACT_WORD" |
459
| data | obj | 进入直播间的用户的信息 | |
460
461
data字段
462
463
| 字段 | 类型 | 内容 | 备注 |
464
| ---- | ---- | ------ | --------- |
465
| id | num | 事件ID | |
466
| status | num | 状态 | |
467
| type | num | 事件类型 | |
468
| data | str | 事件数据 | |
469
470
连续发送弹幕事件的data.data字段
471
472
| 字段 | 类型 | 内容 | 备注 |
473
| ---- | ---- | ------ | --------- |
474
| combo | array | 连续发送弹幕事件信息 | |
475
| merge_interval | num | 合并弹幕时间间隔 | |
476
| card_appear_interval | num | 弹窗出现时间间隔 | |
477
| send_interval | num | 发送时间间隔 | |
478
479
连续发送弹幕事件的data.data.combo字段
480
481
| 字段 | 类型 | 内容 | 备注 |
482
| ---- | ---- | ------ | --------- |
483
| id | num | 时间ID | |
484
| status | num | 状态 | |
485
| content | str | 重复的弹幕内容 | |
486
| cnt | num | 重复数量 | |
487
| guide | str | 标题词 | "他们都在说:" |
488
| left_duration | num | 左移时长 | |
489
| fade_duration | num | 淡化时长 | |
490
491
<details>
492
<summary>查看消息示例：</summary>
493
494
```json
495
{
496
'': 6785480089600,
497
'status': 4,
498
'type': 102,
499
'data': '{
500
"combo":[{
501
"id":6785480089600,
502
"status":4,
503
"content":"晚安",
504
"cnt":3,
505
"guide":"他们都在说:",
506
"left_duration":20000,
507
"fade_duration":60000}],
508
"merge_interval":1000,
509
"card_appear_interval":1000,
510
"send_interval":1000}'
511
}
512
```
513
514
</details>
515
449
516
#### 进场或关注消息
450
517
451
518
有用户进入直播间或关注主播时触发
@@ -573,6 +640,85 @@ data字段
573
640
574
641
</details>
575
642
643
#### 用户庆祝消息
644
645
json格式
646
647
| 字段 | 类型 | 内容 | 备注 |
648
| ---- | ---- |------------------|----------------------------------|
649
| cmd | str | "USER_TOAST_MSG" | 用户购买舰长 / 提督 / 总督后的庆祝消息，内容包含用户陪伴天数 |
650
| data | obj | 上舰人uid & 昵称、上舰信息 | |
651
652
data字段
653
654
| 字段 | 类型 | 内容 | 备注 |
655
| ---- |-----|--------------------------|-----|
656
| anchor_show | bool | 是否显示 | |
657
| color | str | 颜色 | |
658
| dmscore | num | 待调查 | |
659
| effect_id | num | 待调查 | |
660
| face_effect_id | num | 待调查 | |
661
| gift_id | num | 礼物id | |
662
| group_name | str | 待调查 | |
663
| group_op_type | num | 待调查 | |
664
| group_role_name | str | 待调查 | |
665
| guard_level | num | 大航海等级 | 1: 总督 2: 提督 3:舰长 |
666
| is_group | num | 待调查 | |
667
| is_show | num | 待调查 | |
668
| num | num | 上舰个数 | |
669
| op_type | num | 待调查 | |
670
| payflow_id | str | 待调查 | |
671
| price | num | 价格 |
672
| role_name | str | 身份名称 | |
673
| room_effect_id | num | 待调查 | |
674
| room_group_effect_id | num | 待调查 | |
675
| start_time | num | 待调查 | |
676
| svga_block | num | 待调查 | |
677
| target_guard_count | str | 庆祝消息正文 | |
678
| toast_msg | num | 待调查 | |
679
| uid | num | 上舰人UID | |
680
| unit | str | 购买身份时间单位 | |
681
| user_show | bool | 待调查 | |
682
| username | str | 上舰人用户名 | |
683
684
<details>
685
686
<summary>查看消息示例：</summary>
687
688
```json
689
{
690
'anchor_show': True,
691
'color': '#00D1F1',
692
'dmscore': 90,
693
'effect_id': 397,
694
'end_time': 1702580687,
695
'face_effect_id': 44,
696
'gift_id': 10003,
697
'group_name': '',
698
'group_op_type': 0,
699
'group_role_name': '',
700
'guard_level': 3,
701
'is_group': 0,
702
'is_show': 0,
703
'num': 1,
704
'op_type': 1,
705
'payflow_id':'2312150304155852173446521',
706
'price': 138000,
707
'role_name': '舰长',
708
'room_effect_id': 590,
709
'room_group_effect_id': 1337,
710
'start_time': 1702580687,
711
'svga_block': 0,
712
'target_guard_count': 146,
713
'toast_msg': '<%无光之日%> 在主播Mia米娅-的直播间开通了舰长，今天是TA陪伴主播的第1天',
714
'uid': 79667344,
715
'unit': '月',
716
'user_show': True,
717
'username': '无光之日'}
718
```
719
720
</details>
721
576
722
#### 醒目留言
577
723
578
724
json格式
@@ -1404,6 +1550,44 @@ list数组中的对象
1404
1550
1405
1551
</details>
1406
1552
1553
#### 直播间在人气榜的排名改变
1554
1555
1556
json格式
1557
1558
| 字段 | 类型 | 内容 | 备注 |
1559
| ---- | ---- | ------ | --------- |
1560
| cmd | str | "POPULAR_RANK_CHANGED" | |
1561
| data | obj | 直播间的人气榜排名信息 | |
1562
1563
data字段
1564
1565
| 字段 | 类型 | 内容 | 备注 |
1566
| ---- | ---- | ------ | --------- |
1567
| uid | num | 主播UID | |
1568
| rank | num | 人气榜排名 | |
1569
| countdown | num | 人气榜下轮结算剩余时长 | |
1570
| timestamp | num | 触发时的Unix时间戳 | |
1571
| timestamp | str | 待调查 | |
1572
1573
<details>
1574
<summary>查看消息示例：</summary>
1575
1576
```json
1577
{
1578
'cmd': 'POPULAR_RANK_CHANGED',
1579
'data': {
1580
'uid': 780791,
1581
'rank': 36,
1582
'countdown': 1927,
1583
'timestamp': 1702578474,
1584
'cache_key': 'rank_change:91a4e81ba3034ae894d61e432aa13081'
1585
}
1586
}
1587
```
1588
1589
</details>
1590
1407
1591
#### 直播间用户点赞
1408
1592
1409
1593
json格式