LICENCE：AGPL-3.0

注：当前版本鲁棒性不高，在网络波动时会导致下载失败（查看详情），建议在下载时保持页面在最上层。还有好些比较粗糙的地方，下次更新时尽量尽量尽量优化...

PS: 如果接受命令行下载工具，更推荐使用you-get来下载视频，用pip3 install you-get就能安装上，简单易用...

1. 使用了PySide6构建图形界面
2. 使用了httpx以协程方式下载
3. 借鉴了Java接口式、面向对象开发 (Java初学者的一次尝试😆)
4. 准 - 全类型标注（尽力了...）

• 能够下载bilibili单集的普通视频
• 能够下载bilibili多集的普通视频
• 能够下载bilibili番剧&电影

1. 在电脑浏览器上找到想要下载的b站视频，复制网页链接
2. 在“视频链接”后的文本输入框内粘贴该链接，另外：
   • 下载单集视频或者多集视频的全部：直接传入B站视频链接，例：bilibili.com/video/BV11K411376D
   • 下载其中一集:传入那一集的链接 (网址中会包含 ?p=)，例：bilibili.com/video/BV11K411376D?p=8
3. 点击“下载”按钮

1. 在“设置”-“设置cookie”中添加自己的SESSDATA (内含操作示意图)
2. 在电脑浏览器上找到想要下载的番剧，复制网页链接
3. 需要注意的是：
   • 如果想要下载番剧所属的全部视频，则网址中会包含 ss， 例：bilibili.com/bangumi/play/ss39481
   • 如果想要下载番剧的某一集，则网址中会包含 ep， 例：bilibili.com/bangumi/play/ep424836/
4. 点击“下载”按钮

• 开发本程序仅用于学习交流，请勿用于任何商业用途！
• 普通视频的解析器是不需要用户自行更新cookies的加密版本；番剧/电影的下载器需要在“设置”-“设置cookie”中添加自己的SESSDATA。
• ui中的“主进度”其实是正在下载的文件的序号占下载任务总数的百分比，因此由于协程下载的特性，会在各个文件反复横跳，因此“主进度”仅用于提升观赏效果。
• 正因如此，本程序同时下载多集视频的效率远高于下载单集视频。

• 优化：下载地址会记录原视频链接
• 优化：优化界面，(新增按钮：打开保存目录)

• 变更：设置采用Json文件来储存设置信息，增强向下兼容性
• 新增：可自定义异步下载数量上限
• 新增：打开保存地址的按钮

• 优化：视频下载后生成原视频地址快捷方式
• 修复：视频末尾若有空格会导致本地路径不匹配
• 优化：设置异步下载数量上限为5个（若无上限，在大量任务时会出错）

• 修复：如果视频单集标题含有/ 时会出错的bug
• 优化：将pyside2替换升级为pyside6

• 优化：文件名新增集数前缀，如(P1)
• 优化：多个vip视频的情况会导致连环弹窗，更改为只弹窗一次

• 新增：检查更新功能
• 优化：部分交互

• 新增：番剧/电影下载功能
• 新增：可设置cookie
• 修复：因为未转义导致的日志写入异常

• 修复：日志只在重启程序后才刷新的bug

• 新增：能够下载bilibili的普通视频
• 修复：包含 ?p=的链接会解析错误
• 修复：在下载期间退出窗口，子线程仍在后台下载 或 主线程卡死无法退出
• 修复：变更保存路径后，需要重启才能恢复，否则会报错

• 下载视频的接口参考了
  • GitHub@Henry 的相关项目：Henryhaohao/Bilibili_video_download
  • bilibili@凡云 的文章 《2020年B站番剧相关API整合》

VideoHandler在初始化时，会调用get_proper_video_parser方法，如下方代码所示

# video_handler.py
class VideoHandler:
    def __init__(self, url, quality: Union[str, int], video_format: str, save_path: Path):
		# ...
        self.video_parser: VideoParserInterface = self.get_proper_video_parser()

    def get_proper_video_parser(self) -> VideoParserInterface:
        if "bangumi" in self.url:
            return FanVideoParser(self.url, self.quality)  # 为了下载番剧/电影的解析器
        else:
            return NormalVideoParser(self.url, self.quality)  # 默认的解析器

可以在此方法中自定义返回的视频分析器(继承自VideoParserInterface)

# video_parsers.py
class VideoParserInterface(abc.ABC):
    def __init__(self, url: str, quality: Union[str, int]):
        # ...
        self.downloader_list: List[VideoDownloader] = self.get_downloader_list()

    @abc.abstractmethod
    def get_downloader_list(self) -> List[VideoDownloader]:
        pass

downloader_list中的VideoDownloader，是下载器对象，下载方法用的异步函数

# my_classes.py
class VideoDownloader:
    def __init__(self, title, page: PageInAPI):
        self.title = title
        self.page = page
        self.local_path = Path(__file__)  # 这里是随便设个值，反正后面要改

    async def download(self, save_path: Path, video_format: str = ".flv",
                       all_progress_value: Union[int, float] = 0, headers: dict = None):
        # ...
        with open(self.local_path / video_name, 'wb') as f:
            async with async_downloader.stream('GET', url) as response:
                async for chunk in response.aiter_bytes():
                    f.write(chunk)

VideoDownloader.page 的类型(PageInAPI)是用于记录某一集视频的详细信息 (命名由来：b站的API对某一集的视频的名为Page)，初始化参数info_dict是从api传来的json数据（转成字典后做实参传入）。特别说明，VideoDownloader.title类似于电视剧剧名，会作为文件夹的名字；此处的PageInAPI.part类似于电视剧每一集的集名，会作为视频的名称。

# my_classes.py
class PageInAPI:
    """用于记录api中的单个Page的信息"""
    def __init__(self, info_dict: Dict[str, Union[int, str]]):
        self.part: str = info_dict.get("part", '视频名')
        self.url: List[str] = []
        self.size: List[int] = []
        # ...其他属性非必需，可以根据实际情况置空
        
    def set_url(self, url: str):
        self.url.append(url)

    def set_size(self, size: int = 1):
        self.size.append(size)

综上所述，若需要扩展其他下载器，或许可按以下步骤改写：

1. 自定义视频分析器(继承自VideoParserInterface)，并重写get_downloader_list方法，使其能返回List[VideoDownloader]
2. 更改VideoHandler.get_proper_video_parser中的逻辑，使其在指定条件下返回新的视频分析器。