# B23Downloader

**Repository Path**: boarmy_1_boarmy/B23Downloader

## Basic Information

- **Project Name**: B23Downloader
- **Description**: 下载B站 视频（投稿视频、番剧、电影、课程）、直播、漫画。（使用 Qt C++ 开发）
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2022-02-02
- **Last Updated**: 2022-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
  <br>
  <img src="./B23Downloader/icons/icon-96x96.png" alt="B23Downloader-icon" />
  <br>
  B23Downloader
  <br>
</h1>

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

+ 下载链接：[GitHub](https://github.com/vooidzero/B23Downloader/releases) ／ [南大Git](https://git.nju.edu.cn/zero/B23Downloader/-/releases)

+ [使用说明](#使用说明)

+ [Build-Issues](#build-issues)

+ [开发日志](#开发日志)



# 使用说明

## Main Window

<img src="./README.assets/mainwindow.png" alt="mainwindow" width="500" />

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

<br>

## 下载位置

### 视频类

<img src="./README.assets/download-example-bangumi.png" alt="download-example-bangumi" width="400" />

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

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

### 漫画

<img src="./README.assets/download-example-manga.png" alt="download-example-manga" width="400" />

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

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

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

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

### 直播

<img src="./README.assets/download-example-live.png" alt="download-example-live" width="400" />

上图中，对话框的标题为 *【哔哩哔哩英雄联盟赛事】【直播】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），那么这个直播下载任务会处于“等待下载”状态。

<br>

## 支持的 URL 输入

- 用户投稿类视频链接 ，不支持互动视频
- 剧集（番剧，电影等）链接 ，暂不支持活动页链接如[「天气之子」B站正在热播！](https://www.bilibili.com/blackboard/topic/activity-jjR1nNRUF.html)
- 课程类视频链接
- 直播链接
- 直播活动页链接，如 [Aimer线上演唱会 "Walpurgis"](https://live.bilibili.com/blackboard/activity-Aimer0501pc.html)
- 漫画链接，暂不支持 Vomic
- b23.tv 视频短链，b22.top 漫画短链

部分类型可以使用编号：

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

<br>

## 网络代理

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

<br>

# 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](https://stackoverflow.com/questions/53805704/tls-initialization-failed-on-get-request/59072649#59072649).

<br>

# 开发日志
+ **正在考虑代码重构**
  
+ 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>

<br>

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