Awesome

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，比如<b>【哔哩哔哩英雄联盟赛事】【直播】HLE vs LNG [2021.10.05] 18.59.22.flv</b>，其所在文件夹为上图中所选的 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

  <details><summary>解决了一个老问题：下载的直播视频文件无法拖动进度条（需要极长时间来完成响应）</summary> <p>最初我是用 <a href="https://ffmpeg.org/">ffmpeg</a> 来下载直播的，那时得到的文件并没有问题。2021 年 05 月，我尝试用 wget 直接下载而不是通过 ffmpeg，发现下载的文件有「无法拖动进度条」的问题，如果用 ffmpeg 处理 (remux) 一下就正常了：<code>ffmpeg -i &lt;raw_file&gt; -c copy &lt;remuxed_file&gt;</code>。</p> <p>由于不想引入 ffmpeg 依赖，而且 FLV 还算简单，我决定自己实现 FLV remuxing. 首先就是读 <a href="https://www.adobe.com/content/dam/acom/en/devnet/flv/video_file_format_spec_v10_1.pdf">Adobe FLV 文档</a>，挺少的也就 10 页。然后写了些代码解析并打印信息（FlvParse.exe 这小工具有些问题，没解析出 AMF Object，tag header 中 duration 也是错的）。</p> <table><tr><td><img src="./README.assets/FlvParse-LiveSample.png/" alt="FLV Parse Result: Live-Sample" border=0></td><td><img src="./README.assets/FlvParse-Normal.png" alt="FLV Parse Result: Normal" border=0></td></tr></table> <b>比对下载的直播原始数据和 B 站常规（非直播）视频 FLV，发现了以下问题：</b><ul> <li>常规 FLV 文件的时间轴是从 0 开始的；而直播流 FLV 时间轴是直播已持续的时间，下载得到的文件时间轴并不是从 0 开始。在把时间轴改为从 0 开始后，PotPlayer 就能正常 seek 了</li> <li>常规视频头部的 onMetaData 中有个名为 keyframes 的 Object，包含 filepositions 和 times 两个数组。同时发现：<ul><li>对于 PotPlayer，FLV 有没有 keyframes 结构基本没有区别（这怎么做到的？！）；</li><li>对于 VLC，没有 keyframes 的话 seek 会很慢（磁盘开销大，应该是顺序读过去），不过之后再 seek 就很快了（应该是把读过的部分 keyframes 记下来了）。</li></ul></li></ul> <a href="https://rec.danmuji.org/">B站录播姬</a>的做法是在头部留一个 spacer 大数组，其结构是：<ul><li><code>"keyframes:{ "times":[], "filepositions":[], "spacer":[] }"</code></li></ul> 如果关键帧 3 秒一个的话，占用一百多 KB 就能够支撑 5 小时。<br> 我的实现做了个小优化，把结构改成了: <ul><li><code>"keyframes:{ "times":[], "spacer1":[], "filepositions":[], "spacer2":[] }"</code></li></ul> <br><b>参考：</b><a href="https://www.adobe.com/content/dam/acom/en/devnet/flv/video_file_format_spec_v10_1.pdf">Adoebe Flash Video File Format Specification Version 10.1.pdf</a> </details>

• 2021/10/02

  <details><summary>在 Windows 上保证只运行一个实例</summary> <p>位置：main.cpp</p> <p>需求：在打开时，如果应用已在运行，则弹出已在运行的应用窗口，新运行的应用退出。</p> <br> <p>通过搜索引擎可以找到 <a href="https://github.com/qtproject/qt-solutions/tree/master/qtsingleapplication">QtSingleApplication</a>, <a href="https://github.com/itay-grudev/SingleApplication">SingleApplication</a>, 以及一些轻量些的解决方法。其中，因为一些资源在 Unix 平台上由 qt 而不是 os 拥有，其在程序崩溃后不会被回收，所以在 Unix 平台时要多一些操作。<b>简单起见，我就不管 Windows 之外的平台了</b>。</p> <p>要判断应用是否已在运行，可以在执行时尝试创建某种命名的资源，如果返回错误“已被创建”，则说明应用已在运行。可选的有: QSharedMemory, QLockFile, <a href="https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-createmutexa">CreateMutexA</a> (WinApi) 等</p> <p>弹出已在运行的应用，网上找到的都是用 <code>QLocalServer</code> 和 <code>QLocalSocket</code> 实现的，<b>本质就是进程间通信</b>。在 Windows 上，<a href="https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setforegroundwindow#remarks">设置窗口到最前方 (foreground) 是有限制的</a>，即应用不能自己把自己弹到最前面（防止流氓程序）。foreground 程序将另一个程序设置为 foreground 是允许的，这里新运行的那个程序就是 foreground。让新进程获取原进程的 hWnd (handle to a window)，如果已最小化就调用 <a href="https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-showwindow">ShowWindow(hWnd, SW_RESTORE)</a>，否则调用 <a href="https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setforegroundwindow">SetForegroundWindow(hWnd)</a>。</p> <br> <p>最后选择用 QSharedMemory 来实现 HWND 的共享，QSharedMemory::create() 用来判断应用是否已运行。</p> </details>

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