docs: 更新文档描述,简化视频合集/视频列表的配置

This commit is contained in:
amtoaer
2025-01-17 17:53:32 +08:00
parent 276fb5b3e4
commit 60604aeb33
4 changed files with 9 additions and 13 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 272 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 484 KiB

After

Width:  |  Height:  |  Size: 289 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 479 KiB

After

Width:  |  Height:  |  Size: 296 KiB

View File

@@ -1,23 +1,19 @@
# 获取视频合集/视频列表信息
要说明的是,视频合集和视频列表虽然在哔哩哔哩网站交互上行为类似,但在接口层级是两个不同的概念。可以简单将视频列表理解为一个老旧版本的视频合集
视频合集和视频列表虽然在哔哩哔哩网站交互上行为类似,但在接口层级是两个不同的概念,程序配置中需要对两者做出区分
在调试过程中我注意到视频列表的 ID 可以通过某种规则转换为视频合集的 ID从而成功调用视频合集的接口但由于不清楚具体的转换策略在 bili-sync 的实现中还是将其当成两种类型处理。
## 区分方法
这两种类型可以很容易地通过如下手段区分:
1. 两者的名称前缀不同,视频合集会有显式的“合集”字样
2. 两者的图标不同
如下图所示,“合集【命运方舟全剧情解说】”是视频合集,而“阿拉德冒险记”是视频列表。
![image](./assets/collection.webp)
## 配置形式与区分方法
在 bili-sync 的设计中,视频合集的 key 为 `season:{mid}:{season_id}`,而视频列表的 key 为 `series:{mid}:{series_id}`
## 参数获取
新版本 b 站网页端已经对两种类型做了初步整合,将需要的参数展示在了视频合集/视频列表的 URL 中不再需要手动查看接口。URL 的路径格式为:
了解了区分方法后,我们可以通过如下步骤获取视频合集/视频列表的信息。
```
/{mid}/lists/{id}?type={season/series}
```
点开你想要订阅的视频合集/视频列表详情,查看 URL 即可拼接出对应的 key。
### 视频合集