mirror of
https://github.com/ucmao/media-parser.git
synced 2026-11-20 08:04:56 +08:00
抖音视频封面优先使用静态原图避免客户端动图闪烁
This commit is contained in:
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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()
|
||||
|
||||
Reference in New Issue
Block a user