抖音视频封面优先使用静态原图避免客户端动图闪烁

This commit is contained in:
ucmao
2026-09-17 20:47:24 +08:00
parent 63e88d8e0f
commit 5e1e3dcba4
3 changed files with 57 additions and 6 deletions
+6
View File
@@ -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)
+12 -6
View File
@@ -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
+39
View File
@@ -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()