B23Downloader

B23Downloader: 下载B站视频/直播/漫画

下载链接：GitHub
使用说明
Build-Issues
开发日志

使用说明

Main Window

简单，但也够用了。没有历史记录功能。（当然，对于正在下载的任务，关闭程序后再打开还是在的）

下载位置

视频类

在上图中，选择的下载位置为 E:/tmp，那么选中的两个视频分别下载到

E:/tmp/天气之子原版.flv 和
E:/tmp/天气之子预告花絮 MV1 爱能做到的还有什么.flv

漫画

如上图，下载位置还是 E:/tmp，选中的两项分别下载到文件夹

E:/tmp/恋如雨止 81 第81话/ 和
E:/tmp/恋如雨止 82 最终话/

漫画是一页一页下载的，在该示例中，82 最终话 将下载为 E:/tmp/恋如雨止 82 最终话/01.jpg - 32.jpg（32 张图片）。

目前删除漫画下载任务会粗暴地删除整个文件夹，如示例中的 E:/tmp/82 最终话/

直播

上图中，对话框的标题为 【哔哩哔哩英雄联盟赛事】【直播】HLE vs LNG，其命名规则为【<用户名>】<房间标题>，示例中用户名为 哔哩哔哩英雄联盟赛事，房间标题为 【直播】HLE vs LNG。

下载文件的命名为 <标题> <下载开始时间>.flv，比如【哔哩哔哩英雄联盟赛事】【直播】HLE vs LNG [2021.10.05] 18.59.22.flv，其所在文件夹为上图中所选的 E:/tmp/

目前的直播下载任务策略为：

暂停直播下载任务后重新开始，会写入另一个文件，比如【哔哩哔哩英雄联盟赛事】【直播】HLE vs LNG [2021.10.05] 19.32.11.flv
删除任务不会删除任何相关文件
任务不会被保存，即退出程序后再启动，之前的直播下载任务不被保留

如果添加直播下载任务时，正在下载的任务数量超过最大可同时下载任务数（代码里硬编码为 3），那么这个直播下载任务会处于“等待下载”状态。

支持的 URL 输入

用户投稿类视频链接，不支持互动视频
剧集（番剧，电影等）链接，暂不支持活动页链接如「天气之子」B站正在热播！
课程类视频链接
直播链接
直播活动页链接，如 Aimer线上演唱会 "Walpurgis"
漫画链接，暂不支持 Vomic
b23.tv 视频短链，b22.top 漫画短链

部分类型可以使用编号：

视频 BV 或 av 号，如 BV1ab411c7St 或 av35581924
剧集 ssid 或 epid，如 ss28341 或 ep281280
live+直播房间号，如 live6

网络代理

暂未实现“设置”功能（以后有时间会加上的），代理跟随系统，你可以设置全局代理来下载地域限制内容（比如代理服务器在香港，那么可以下载“仅限港澳台地区”的动漫）。

Build-Issues

B23Downloader 使用 Qt 6 (C++ 17) 开发，虽然 Release 只有 Windows 64-bit 的，但你可以在其他桌面平台编译使用。

由于所有请求链接均采用 HTTPS，所以依赖 OpenSSL库。在 Windows 上，虽然 Qt Installer 可以勾选 OpenSSL Toolkit，但 Qt Installer 并不会设置好相关环境，于是会出现找不到 SSL 库的错误（如 TLS initialization failed），解决方法参考 TLS initialization failed on GET Request - Stack Overflow.

开发日志

正在考虑代码重构
2021/10/08 - 2021/10/11
解决了一个老问题：下载的直播视频文件无法拖动进度条（需要极长时间来完成响应）

最初我是用 ffmpeg 来下载直播的，那时得到的文件并没有问题。2021 年 05 月，我尝试用 wget 直接下载而不是通过 ffmpeg，发现下载的文件有「无法拖动进度条」的问题，如果用 ffmpeg 处理 (remux) 一下就正常了：ffmpeg -i <raw_file> -c copy <remuxed_file>。

由于不想引入 ffmpeg 依赖，而且 FLV 还算简单，我决定自己实现 FLV remuxing. 首先就是读 Adobe FLV 文档，挺少的也就 10 页。然后写了些代码解析并打印信息（FlvParse.exe 这小工具有些问题，没解析出 AMF Object，tag header 中 duration 也是错的）。

比对下载的直播原始数据和 B 站常规（非直播）视频 FLV，发现了以下问题：
- 常规 FLV 文件的时间轴是从 0 开始的；而直播流 FLV 时间轴是直播已持续的时间，下载得到的文件时间轴并不是从 0 开始。在把时间轴改为从 0 开始后，PotPlayer 就能正常 seek 了
- 常规视频头部的 onMetaData 中有个名为 keyframes 的 Object，包含 filepositions 和 times 两个数组。同时发现：
  - 对于 PotPlayer，FLV 有没有 keyframes 结构基本没有区别（这怎么做到的？！）；
  - 对于 VLC，没有 keyframes 的话 seek 会很慢（磁盘开销大，应该是顺序读过去），不过之后再 seek 就很快了（应该是把读过的部分 keyframes 记下来了）。
B站录播姬的做法是在头部留一个 spacer 大数组，其结构是：
- "keyframes:{ "times":[], "filepositions":[], "spacer":[] }"
如果关键帧 3 秒一个的话，占用一百多 KB 就能够支撑 5 小时。
我的实现做了个小优化，把结构改成了:
- "keyframes:{ "times":[], "spacer1":[], "filepositions":[], "spacer2":[] }"
参考：Adoebe Flash Video File Format Specification Version 10.1.pdf
2021/10/02

在 Windows 上保证只运行一个实例

位置：main.cpp

需求：在打开时，如果应用已在运行，则弹出已在运行的应用窗口，新运行的应用退出。

通过搜索引擎可以找到 QtSingleApplication, SingleApplication, 以及一些轻量些的解决方法。其中，因为一些资源在 Unix 平台上由 qt 而不是 os 拥有，其在程序崩溃后不会被回收，所以在 Unix 平台时要多一些操作。简单起见，我就不管 Windows 之外的平台了。

要判断应用是否已在运行，可以在执行时尝试创建某种命名的资源，如果返回错误“已被创建”，则说明应用已在运行。可选的有: QSharedMemory, QLockFile, CreateMutexA (WinApi) 等

弹出已在运行的应用，网上找到的都是用 QLocalServer 和 QLocalSocket 实现的，本质就是进程间通信。在 Windows 上，设置窗口到最前方 (foreground) 是有限制的，即应用不能自己把自己弹到最前面（防止流氓程序）。foreground 程序将另一个程序设置为 foreground 是允许的，这里新运行的那个程序就是 foreground。让新进程获取原进程的 hWnd (handle to a window)，如果已最小化就调用 ShowWindow(hWnd, SW_RESTORE)，否则调用 SetForegroundWindow(hWnd)。

最后选择用 QSharedMemory 来实现 HWND 的共享，QSharedMemory::create() 用来判断应用是否已运行。

最后感谢 SocialSisterYi/bilibili-API-collect: 哔哩哔哩-API收集整理，虽然 B23Downloader 里用的 API 有很大一部分是我自己后面找的。以后有时间也为这个仓库贡献一下。

Z-bin/B23Downloader