From 5e1e3dcba4ff0f5a1cca07a27b5295961ba48a68 Mon Sep 17 00:00:00 2001 From: ucmao <294323976@qq.com> Date: Thu, 17 Sep 2026 20:47:24 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8A=96=E9=9F=B3=E8=A7=86=E9=A2=91=E5=B0=81?= =?UTF-8?q?=E9=9D=A2=E4=BC=98=E5=85=88=E4=BD=BF=E7=94=A8=E9=9D=99=E6=80=81?= =?UTF-8?q?=E5=8E=9F=E5=9B=BE=E9=81=BF=E5=85=8D=E5=AE=A2=E6=88=B7=E7=AB=AF?= =?UTF-8?q?=E5=8A=A8=E5=9B=BE=E9=97=AA=E7=83=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/parsers/douyin.md | 6 ++++++ src/parsers/douyin_parser.py | 18 +++++++++++------ tests/test_douyin_parser.py | 39 ++++++++++++++++++++++++++++++++++++ 3 files changed, 57 insertions(+), 6 deletions(-) diff --git a/docs/parsers/douyin.md b/docs/parsers/douyin.md index 321a325..327e9d0 100644 --- a/docs/parsers/douyin.md +++ b/docs/parsers/douyin.md @@ -186,6 +186,12 @@ abogus = signer.get_abogus(play_url, signer.user_agent) * **超清音视频分离提取**:从 `videoModel.dynamicVideo` 提取最高清 H.264 视频流(`video_url`)与独立音轨(`audio_url`); * 💡 **关于「抖音独播/独家」画面角标**:部分独播影视与演唱会长片画面右上角会显示「抖音 独播」或「独家」标签,该角标属于官方源片入库转码时**硬编码(Burned-in)压制进视频每一帧画面中的电视台标式台标**(即使在官方 App 内离线缓存也是带标的),提取到的已是官方服务器存储的最高清原始片源。 +### 4.6 视频静态封面提取与优先级策略 +* **封面优先级设计**:`origin_cover`(原始静态原图) $\rightarrow$ `cover`(常规静态图) $\rightarrow$ `dynamic_cover`(动态 WebP 动图兜底); +* **设计动因**: + 1. **画质与裁剪**:`origin_cover` 是创作者选定的原始封面帧,画质最高且未经系统裁剪压缩; + 2. **兼容性与性能**:`dynamic_cover` 是带动画的 WebP 动图(通常 300KB~2MB),若直接作为缩略图会导致部分客户端/Web 控件持续循环解码闪烁,优先静态原封面可将体积压缩 80% 以上并杜绝动图闪烁。 + --- ## 5. 常见踩坑记录与风控解法 (Gotchas) diff --git a/src/parsers/douyin_parser.py b/src/parsers/douyin_parser.py index b43ca73..86b5c32 100644 --- a/src/parsers/douyin_parser.py +++ b/src/parsers/douyin_parser.py @@ -1225,7 +1225,7 @@ class DouyinParser(BaseParser): ep_info = data_dict['episode_list'][0] elif not ep_info and data_dict.get('aweme_list'): ep_info = data_dict['aweme_list'][0] - for k in ('cover_url', 'poster_url', 'dynamic_cover', 'cover'): + for k in ('cover_url', 'poster_url', 'origin_cover', 'cover', 'dynamic_cover'): val = ep_info.get(k) if isinstance(val, dict): url_list = val.get('url_list') or val.get('urlList') or [] @@ -1242,13 +1242,19 @@ class DouyinParser(BaseParser): detail = data_dict.get('aweme_detail') or {} - # 1. 尝试获取视频动态封面 + # 1. 优先获取视频静态封面(origin_cover -> cover -> dynamic_cover 兜底) video_cover = None video_data = detail.get('video') or {} - if video_data and 'dynamic_cover' in video_data: - url_list = video_data['dynamic_cover'].get('url_list') or [] - if url_list: - video_cover = url_list[0] + for cover_key in ('origin_cover', 'cover', 'dynamic_cover'): + cover_obj = video_data.get(cover_key) + if isinstance(cover_obj, dict): + url_list = cover_obj.get('url_list') or cover_obj.get('urlList') or [] + if url_list: + video_cover = url_list[0] + break + elif isinstance(cover_obj, str) and cover_obj: + video_cover = cover_obj + break # 2. 尝试获取图集封面 (如果视频封面不存在) images_cover = None diff --git a/tests/test_douyin_parser.py b/tests/test_douyin_parser.py index cb5e1a6..410016e 100644 --- a/tests/test_douyin_parser.py +++ b/tests/test_douyin_parser.py @@ -859,6 +859,45 @@ class DouyinParserTest(unittest.TestCase): self.assertEqual(len(images), 1) self.assertEqual(images[0], "https://p3.douyinpic.com/img1.jpg") + def test_cover_photo_priority_origin_over_cover_and_dynamic(self): + data = { + "aweme_detail": { + "desc": "封面优先级测试", + "video": { + "origin_cover": {"url_list": ["https://p3.douyinpic.com/origin_cover.jpg"]}, + "cover": {"url_list": ["https://p3.douyinpic.com/normal_cover.jpg"]}, + "dynamic_cover": {"url_list": ["https://p3.douyinpic.com/dynamic_cover.webp"]}, + } + } + } + parser = self.make_parser(data) + self.assertEqual(parser.get_cover_photo_url(), "https://p3.douyinpic.com/origin_cover.jpg") + + def test_cover_photo_fallback_to_cover_when_no_origin(self): + data = { + "aweme_detail": { + "desc": "无origin_cover时降级cover", + "video": { + "cover": {"url_list": ["https://p3.douyinpic.com/normal_cover.jpg"]}, + "dynamic_cover": {"url_list": ["https://p3.douyinpic.com/dynamic_cover.webp"]}, + } + } + } + parser = self.make_parser(data) + self.assertEqual(parser.get_cover_photo_url(), "https://p3.douyinpic.com/normal_cover.jpg") + + def test_cover_photo_fallback_to_dynamic_when_no_static(self): + data = { + "aweme_detail": { + "desc": "无静态封面时降级动图", + "video": { + "dynamic_cover": {"url_list": ["https://p3.douyinpic.com/dynamic_cover.webp"]}, + } + } + } + parser = self.make_parser(data) + self.assertEqual(parser.get_cover_photo_url(), "https://p3.douyinpic.com/dynamic_cover.webp") + if __name__ == "__main__": unittest.main()