feat(media): 透传高清首帧 poster 地址
backend-ci / test (push) Failing after 5m17s

This commit is contained in:
Zhou Weidong committed 2026-11-17 09:49:34 +08:00
1 parent 2904e59e71
commit 31d449916f
11 files changed
+201 -12

No files matched your search

+9
View File
@@ -181,6 +181,9 @@ app.register.max-per-device-per-day
| GET | `/app/dramas/{id}` | 详情(含剧集列表,免费集带**已签名**播放地址) |
| GET | `/app/search?keyword=&pageIndex=&pageSize=` | **匿名**。搜索已上线短剧:按标题/简介模糊匹配,分页返回卡片列表 |
首页、发现页和推荐流的卡片 `preview.posterUrl` 与详情的 `episodes[].posterUrl` 同源,
有 READY 高清 poster 时返回签名地址;没有时为 `null`,客户端回退雪碧图。
`POST /app/dramas/page` 请求体:
```json
@@ -289,6 +292,7 @@ app.register.max-per-device-per-day
"likeCount": "45",
"commentCount": "8",
"playUrl": "/files/episode/202610/xxx.mp4?e=1760000000&s=9f2c...",
"posterUrl": "/files/transcoded/88/poster.jpg?e=1760000000&s=7b1e...",
"thumbnailsUrl": "/files/transcoded/88/thumbnails/thumbnails.vtt?e=1760000000&s=8a1d..."
}
]
@@ -306,6 +310,7 @@ app.register.max-per-device-per-day
| `viewCount` | Long(JSON 字符串) | 取 `drama.view_count`,累计播放量,既有字段语义不变 |
| `episodes[].likeCount` | Long(JSON 字符串) | 本集点赞数,取 `drama_episode.like_count` |
| `episodes[].commentCount` | Long(JSON 字符串) | 本集未删除评论数,按 `episode_id` 统计 |
| `episodes[].posterUrl` | String / null | 本集高清首帧 poster 签名地址;没有 READY 媒资时为 `null`,用于播放首帧占位 |
| `episodes[].thumbnailsUrl` | String / null | 本集雪碧图 WebVTT 时间轴签名地址;没有 READY 产物时为 `null` |
计数是只读快照:互动操作完成后客户端重新拉取详情即可刷新;`Long` 字段一律按字符串下发,
@@ -326,6 +331,7 @@ app.register.max-per-device-per-day
"accessible": true,
"accessType": "FREE",
"playUrl": "/files/episode/202610/xxx.mp4?e=1760000000&s=9f2c...",
"posterUrl": "/files/transcoded/88/poster.jpg?e=1760000000&s=7b1e...",
"qualities": ["AUTO", "720p", "1080p"],
"tracks": [
{"quality": "AUTO", "playUrl": "/files/transcoded/88/master.m3u8?e=1760000000&s=9f2c..."},
@@ -352,6 +358,9 @@ app.register.max-per-device-per-day
`sprite_XXX.jpg#xywh=x,y,w,h`。有 READY `media_thumbnail` 时返回签名地址,
无产物时为 `null`;该字段不影响 `playUrl`、`qualities` 和 HLS/原文件回落。
`posterUrl` 是转码产出的高清首帧 poster 签名地址;有 READY 媒资但没有 poster 时为
`null`。客户端应优先用它作为视频纹理就绪前的占位,雪碧图仅作为回退和拖动预览使用。
**`GET /app/episodes/{id}/stats`(播放页计数刷新)**
只读返回本集点赞数、本集未删除评论数、所属剧收藏数,以及当前用户对