mckero/Bilibili-gadget
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Bilibili-gadget/bilibili-API-collect-master/docs/live/guard.md
T
mckero 8db1d171a0 feat: 重大优化更新 - 修复v14.0并发布Pro版 
✨ 新功能:
- 创建bilibili_audio_downloader_pro.py (Pro版) - 全新架构重构
- 添加config.json配置文件支持
- 新增INSTALL.md详细安装指南
- 新增VERSION_COMPARISON.md版本对比说明

🐛 Bug修复 (v14.0):
- 修复中文编码显示问题
- 修复ffmpeg进度条计算不准确
- 改进yt-dlp下载进度解析
- 添加重试机制和超时设置
- 完善错误处理和日志记录

🏗️ Pro版优势:
- 面向对象架构设计，代码更清晰
- 自定义异常类和智能错误恢复
- 准确的进度条显示算法
- 完整的日志系统
- 灵活的配置管理
- 更好的用户体验

📚 文档更新:
- 更新README.md，添加版本对比指引
- 更新requirements.txt依赖列表
- 完善项目文档结构
2025-09-21 12:02:11 +08:00

593 lines
23 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 查询大航海成员
> https://api.live.bilibili.com/xlive/app-room/v2/guardTab/topListNew
*请求方式: GET*
认证方式：无（无需Cookie）
**URL参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------ | --------------------------------------- |
| roomid | num | 直播间号 | 必要 | |
| page | num | 页数 | 必要 | |
| ruid | num | 主播id | 必要 | |
| page_size | num | 页大小 | 非必要 | 默认20，最大30，若超过则作为10处理 |
| typ | num | 排序方式 | 非必要 | typ=3,4,5分别为按周/月/总航海亲密度排序 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----- | -------------- | --------------------------------------- |
| info | obj | 主播mid | |
| top3 | array | 整个列表的top3 |
| list | array | 大航海成员 | page=1时，list[0]得到的会是榜单的第四名 |
`list`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------- | ----- |
| ruid | num | 主播UID | |
| rank | num | 榜单排名 | |
| accompany | num | 陪伴天数 | |
| uinfo | obj | 用户信息 | |
| score | num | 亲密度 | 恒为0 |
`list`对象的`uinfo`：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | -------------------------------------------------------- |
| uid | num | 用户UID | |
| base | obj | 用户基本信息 | |
| medal | obj | 粉丝牌 | 与[此处](/bilibili-API-collect/docs/user/medals)基本一致 |
`list`对象的`uinfo`的`base`：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ------ | -------- | ---- |
| name | string | 用户名 | |
| face | string | 用戶头像 | |
**示例：**
查询`23174842`直播间的大航海成员
```shell
curl ' https://api.live.bilibili.com/xlive/app-room/v2/guardTab/topListNew?ruid=504140200&roomid=23174842&page=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"info": {
"num": 23,
"page": 10,
"now": 1,
"achievement_level": 1,
"anchor_guard_achieve_level": 0,
"achievement_icon_src": "",
"buy_guard_icon_src": "https://i0.hdslb.com/bfs/live/4a481b491767f9d91165a4631252de4503d63a17.png",
"rule_doc_src": "",
"ex_background_src": "https://i0.hdslb.com/bfs/live/d0e938839a9dee733e8a7f9f6a3a132108ae22bc.png",
"color_start": "",
"color_end": "",
"tab_color": [
"#4DDDDBD5",
"#26CFCBC0"
],
"title_color": [
"#FFC9CCD0",
"#FF9499A0"
]
},
"list": [
{
"ruid": 504140200,
"rank": 4,
"accompany": 36,
"uinfo": {
"uid": 432911315,
"base": {
"name": "幻想乡的年华",
"face": "https://i2.hdslb.com/bfs/face/5ddde7a8466aa2d60d082ccfc08a0267445b193b.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "幻想乡的年华",
"face": "https://i2.hdslb.com/bfs/face/5ddde7a8466aa2d60d082ccfc08a0267445b193b.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 25,
"color_start": 398668,
"color_end": 6850801,
"color_border": 16771156,
"color": 398668,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#4775EFCC",
"v2_medal_color_end": "#4775EFCC",
"v2_medal_color_border": "#58A1F8FF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
},
"wealth": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 5,
"accompany": 513,
"uinfo": {
"uid": 7816639,
"base": {
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 2951253,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#9660E5CC",
"v2_medal_color_end": "#9660E5CC",
"v2_medal_color_border": "#D47AFFFF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#6C00A099",
"user_receive_count": 0
},
"wealth": null,
"title": null,
"guard": {
"level": 3,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
}
],
"top3": [
{
"ruid": 504140200,
"rank": 1,
"accompany": 306,
"uinfo": {
"uid": 85743027,
"base": {
"name": "-小fa---",
"face": "https://i0.hdslb.com/bfs/face/82b2d0fef27b7b69be0d121b3ef0491504bbaae8.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "-小fa---",
"face": "https://i0.hdslb.com/bfs/face/82b2d0fef27b7b69be0d121b3ef0491504bbaae8.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 16771156,
"color": 2951253,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#9660E5CC",
"v2_medal_color_end": "#9660E5CC",
"v2_medal_color_border": "#D47AFFFF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#6C00A099",
"user_receive_count": 0
},
"wealth": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 2,
"accompany": 1005,
"uinfo": {
"uid": 28601039,
"base": {
"name": "捏软软的上帝",
"face": "https://i2.hdslb.com/bfs/face/1f2a9b20294452d5c6ce9f40c66b186ef57b92e5.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "捏软软的上帝",
"face": "https://i2.hdslb.com/bfs/face/1f2a9b20294452d5c6ce9f40c66b186ef57b92e5.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 29,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 16771156,
"color": 2951253,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#9660E5CC",
"v2_medal_color_end": "#9660E5CC",
"v2_medal_color_border": "#D47AFFFF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#6C00A099",
"user_receive_count": 0
},
"wealth": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 3,
"accompany": 95,
"uinfo": {
"uid": 3546834244995088,
"base": {
"name": "老实逸流-恩师软软riu",
"face": "https://i1.hdslb.com/bfs/face/0b1f95d926acfb06c8d7d9c66d2e1fabf3e1a3c4.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "老实逸流-恩师软软riu",
"face": "https://i1.hdslb.com/bfs/face/0b1f95d926acfb06c8d7d9c66d2e1fabf3e1a3c4.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 28,
"color_start": 398668,
"color_end": 6850801,
"color_border": 16771156,
"color": 398668,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#4775EFCC",
"v2_medal_color_end": "#4775EFCC",
"v2_medal_color_border": "#58A1F8FF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
},
"wealth": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
}
],
"my_follow_info": {
"accompany_days": 0,
"auto_renew": 0,
"renew_remind": {
"content": "",
"type": 0,
"hint": ""
},
"rank": 0,
"ruid": 0,
"uinfo": null,
"expired_time": ""
},
"guard_warn": {
"is_warn": 0,
"warn": "",
"expired": 0,
"will_expired": 0,
"address": ""
},
"exist_benefit": false,
"remind_benefit": "立即上船",
"ab": {
"guard_accompany_list": 1
},
"remind_msg": "头号粉丝大航海，上船后可上榜",
"typ": 0,
"extop": null,
"guard_leader": null,
"main_text": "",
"sub_text": "",
"btn_type": 1,
"prompt_text": "头号粉丝大航海，等你来上船"
}
}
```
</details>
## 查询粉丝团成员
> https://api.live.bilibili.com/xlive/general-interface/v1/rank/getFansMembersRank
*请求方式: GET*
认证方式：无（无需Cookie）
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------------- | ------------------- | ----------------------------------------------------------------------------------------------- |
| page | num | 页数 | 必要 | |
| ruid | num | 主播id | 必要 | |
| page_size | num | 每页返回的数量 | 必要 | 最大30，若超过则作为10处理 |
| rank_type | num | 排序方式 | 非必要 | 1：按照粉丝牌还亮着的粉丝团成员的亲密度排序<br> 2：按照**所有**没上过舰的粉丝团成员的亲密度排序 |
| ts | num | 13位时间戳 | 当rank_type=2时必要 | 该值>=1000即可 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ---- |
| item | array | 内容 | |
| num | num | 粉丝团成员数量 |
| medal_status | num | |
`list`对象
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ---- | ---------------------------------------------------------------- | ---- |
| user_rank | num | 排名 |
| uid | num | 用户UID |
| name | str | 用户名 |
| face | str | 用户头像 |
| score | num | 亲密度 |
| medal_name | str | 粉丝牌名字 |
| level | num | 粉丝牌等级 |
| target_id | num | 主播UID |
| guard_level | num | 大航海类型，1，2，3分别为总督，提督，舰长 |
| medal_color_start | num | 粉丝牌渐变起始色 |
| medal_color_end | num | 粉丝牌渐变结束色 |
| medal_color_border | num | 粉丝牌边框颜色 |
| guard_icon | str | 大航海图标URL |
| uinfo_medal | obj | 粉丝牌，与[此处](/bilibili-API-collect/docs/user/medals)基本一致 |
**示例：**
查询用户`504140200`的粉丝团成员
```shell
curl 'https://api.live.bilibili.com/xlive/general-interface/v1/rank/getFansMembersRank?ruid=504140200&page_size=10&page=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"item": [
{
"user_rank": 1,
"uid": 85743027,
"name": "小软兔のfa",
"face": "https://i0.hdslb.com/bfs/face/bdbcabf8d927844ae4f8f9c65862077e29afb989.jpg",
"score": 50990540,
"medal_name": "软饭兔",
"level": 30,
"target_id": 504140200,
"special": "",
"guard_level": 3,
"medal_color_start": 2951253,
"medal_color_end": 10329087,
"medal_color_border": 6809855,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"uinfo_medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 0,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 50990540,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"v2_medal_color_start": "#9660E5CC",
"v2_medal_color_end": "#9660E5CC",
"v2_medal_color_border": "#D47AFFFF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#6C00A099",
"user_receive_count": 0
},
"tag": null,
"is_pokeable": false
},
{
"user_rank": 2,
"uid": 7816639,
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg",
"score": 50704568,
"medal_name": "软饭兔",
"level": 30,
"target_id": 504140200,
"special": "",
"guard_level": 3,
"medal_color_start": 2951253,
"medal_color_end": 10329087,
"medal_color_border": 6809855,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"uinfo_medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 0,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 50704568,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"v2_medal_color_start": "#9660E5CC",
"v2_medal_color_end": "#9660E5CC",
"v2_medal_color_border": "#D47AFFFF",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#6C00A099",
"user_receive_count": 0
},
"tag": null,
"is_pokeable": false
}
],
"num": 89,
"medal_status": 1
}
}
```
</details>
Reference in new issue View Git Blame Copy Permalink