feat: 新增整屏推荐页配置功能
- 7 个固定槽位(1920×1080 两行网格),槽位定义/校验/橘视厅元数据同步 - 海报按槽位自动选:竖图槽取 posterimg、横图槽取 thumbimg,支持自定义覆盖 - 一键导出 zip 交付包:海报按槽位精确尺寸居中裁剪 + config.json + README(am start 拉起命令) - 管理后台接口 6 个(/manage/recommend-page/*),前端对接文档 FE-RECOMMEND-GUIDE.md
This commit is contained in:
48
API_DOC.md
48
API_DOC.md
@@ -252,6 +252,54 @@
|
||||
| `/manage/partner-card/stock` | GET | partner库存查询 |
|
||||
| `/manage/partner-card/list` | GET | 池子记录分页 |
|
||||
|
||||
### 2.22 推荐页配置 `/manage/recommend-page`
|
||||
|
||||
设备厂商 1920×1080 整屏推荐页:运营选片配置 7 个固定槽位,一键导出 zip 交付包(按槽位尺寸裁好的图片 + 影片编号 + am start 拉起命令)。
|
||||
|
||||
| 路径 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/manage/recommend-page/list` | GET | 分页列表(page/limit/name) |
|
||||
| `/manage/recommend-page/info/{id}` | GET | 详情(含 slots 解析后数组) |
|
||||
| `/manage/recommend-page/slot-definitions` | GET | 7 个槽位定义(code/类型/尺寸/默认动作/海报字段) |
|
||||
| `/manage/recommend-page/save` | POST | 新建或更新(有 id 更新) |
|
||||
| `/manage/recommend-page/delete` | POST | 软删除(body: [id]) |
|
||||
| `/manage/recommend-page/export/{id}` | GET | 一键导出 zip 交付包(浏览器下载) |
|
||||
|
||||
**保存请求体**(slot_01~06 必填 contentcode,slot_07 更多入口必填 posterUrl):
|
||||
|
||||
```json
|
||||
{
|
||||
"id": null,
|
||||
"name": "2026年10月推荐",
|
||||
"remark": "备注",
|
||||
"slots": [
|
||||
{ "slotCode": "slot_01", "contentcode": "23010012026061709581101832" },
|
||||
{ "slotCode": "slot_02", "contentcode": "..." },
|
||||
{ "slotCode": "slot_03", "contentcode": "..." },
|
||||
{ "slotCode": "slot_04", "contentcode": "..." },
|
||||
{ "slotCode": "slot_05", "contentcode": "..." },
|
||||
{ "slotCode": "slot_06", "contentcode": "..." },
|
||||
{ "slotCode": "slot_07", "posterUrl": "https://.../more.jpg" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
- 槽位可选字段:`posterUrl`(自定义海报,横图槽位补横版图)、`actionParam`(自定义拉起命令,支持 `{contentcode}`/`{mediaName}` 占位符)
|
||||
- 保存时后端按 contentcode 调橘视厅同步影片名与海报(无效 contentcode 报错)
|
||||
- 海报默认策略:竖图槽(slot_02~04)取 posterimg 竖版,横图槽(slot_01/05/06)取 thumbimg 横版
|
||||
- 拉起命令默认值:DETAIL = `am start -n tv.huashi.jetsenx.jetsenfilx.jsttv.home/com.pukka.jiecheng.MainActivity --es media_id "{contentcode}"`(备选 `--es film_name "{mediaName}"`);LAUNCH = `am start -n tv.huashi.jetsenx.jetsenfilx.jsttv.home/com.pukka.jiecheng.MainActivity`
|
||||
|
||||
**导出 zip 结构**:
|
||||
|
||||
```
|
||||
推荐页_2026年10月推荐.zip
|
||||
├── images/slot_01.png ~ slot_07.png # 按槽位精确尺寸居中裁剪
|
||||
├── recommend_config.json # 含 contentcode/actionType/actionParam(占位符已替换)
|
||||
└── README.txt # 排版与拉起规则说明
|
||||
```
|
||||
|
||||
> 前端下载 zip 需带 JWT 请求头,用 axios blob 方式(`responseType: 'blob'`)下载,不能直接 window.open。
|
||||
|
||||
---
|
||||
|
||||
## 三、第三方开放接口(appKey签名鉴权)
|
||||
|
||||
Reference in New Issue
Block a user