Appearance
页面 × 接口 × 配置映射
本文梳理移动端各核心页面在「接口 → 后台配置 → 数据来源」之间的关联，方便研发、测试和运营在排查问题或新增需求时快速定位。
首页（Home）
| 组件 | 使用接口 | 后台配置 | 数据表 |
|---|---|---|---|
| 顶部一级分类 Tab | GET /api/mobile/v1/home/type_List | 无需配置；自动读取已启用的分类 | mac_type（type_pid = 0、type_status = 1） |
| 二级快捷入口/子分类 | GET /api/mobile/v1/home?typeId={id} → data.children | 与一级分类同源；opensFilter 由后台 Cate 配置决定 | mac_type |
| Banner 轮播 | 同上接口 → data.banner | 后台管理 → APP 管理 → 首页 中的 bannerLevel、bannerNum；可按分类维护 bannerLevel_<typeId> | mac_vod 结合 app_config（type=Index） |
| 推荐模块列表 | 同上接口 → data.modules | cateNum 控制每个模块展示数；排序依赖 mac_type.type_sort | mac_vod（按 typeId 过滤） |
| 热播板块 | 同上接口 → data.hot（当 typeId=0） | hotLevel、hotNum | mac_vod |
| Redis 缓存 | 所有首页数据 | AppConfig.redisStatus、redisKey、redisTime | app_config（type=AppConfig） |
建议：调试首页数据时先确认后台
app_config配置是否开启缓存，必要时在后台暂时关闭或清除对应 key。
筛选页（Filter）
| 组件 | 使用接口 | 后台配置 | 数据表 |
|---|---|---|---|
| 左侧分类树 | GET /api/mobile/v1/vod/filterList | 读取所有启用分类；结构由 mac_type 转树形 | mac_type |
| 分类过滤条件（地区/年份/剧情/首字母等） | 同上接口 → filters 字段 | 后台管理 → APP 管理 → 分类 中的 filter_<typeId> | app_config（type=Cate） |
| 内容列表 | GET /api/mobile/v1/vod/filter/list | Cate.pageNum 决定默认分页大小；sortId 与前端排序控件映射 | mac_vod |
当新增分类或筛选字段时，需要同时：① 在后台
mac_type中创建分类，② 在Cate配置里补充filter_<typeId>的可选项。
搜索页（Search）
| 组件 | 使用接口 | 后台配置 | 数据表 |
|---|---|---|---|
| 搜索建议/热门词 | GET /api/mobile/v1/home/search_hot（如有） | 后台控制策略；默认读取 app_config | 视实现而定 |
| 搜索结果列表 | GET /api/mobile/v1/vod/search?keyword=xxx | 无需配置；自动按名称前缀匹配 | mac_vod |
| 搜索推荐位 | GET /api/mobile/v1/vod/search_recommend（mobile.service.getSearchRecommend） | Search.searchLevel/searchLikeLevel、Search.searchNum/searchLikeNum、searchResultLevel | app_config（type=Search） + mac_vod |
播放页（Playback）
| 模块 | 使用接口 | 后台配置 | 数据表 / 外部服务 |
|---|---|---|---|
| 视频详情（基本信息 + 推荐） | GET /api/mobile/v1/vod/detail?vodId= | AppConfig.redisStatus 控制缓存；推荐数量固定 10 条 | mac_vod、mac_type |
| 播放源列表 | 同上 | AppConfig.playerConfigUrl（远程 JSON）决定可用播放源、显示名称、排序；若配置项 type 为 OFFICIAL，客户端需额外调用官解接口 | 外部配置文件 + mac_vod |
| 官解真实地址 | GET /api/mobile/v1/vod/OfficialPlayUrl | AppConfig.officialUrl、officialUrlField；当播放源 key 属于内置官方列表或在 playerConfig 中标记为 OFFICIAL 时触发 | 外部解析服务 |
| 弹幕数据 | GET /api/mobile/v1/vod/dplayerDanmu | AppConfig.danmuApiUrl | 第三方弹幕服务 |
| 去广告 M3U8 | GET /api/mobile/v1/vod/m3u8?url= | AppConfig.redisStatus / redisTime 控制缓存 | 原始 M3U8 CDN |
如果播放器出现“无法播放”或弹幕缺失，需首先检查
app_config中对应字段是否配置正确，然后再确认第三方服务可用性。
后台页面与配置入口
- APP 管理 → 首页：维护
app_config中 type=Index的 JSON，包括 banner、热播、分类展示数量。 - APP 管理 → 分类：维护 type=
Cate下的筛选配置及分页参数。 - APP 管理 → 搜索：维护 type=
Search，控制搜索推荐逻辑。 - APP 管理 → 基础配置：映射 type=
AppConfig，用于 Redis、官解、弹幕、PlayerConfig 等基础能力。 - 内容管理 → 视频：直接操作
mac_vod记录，影响首页、筛选、搜索、播放等所有页面。
通过以上映射表，可快速回答以下问题：
- 页面展示异常 → 检查对应接口返回，再定位后台配置或数据库源数据。
- 新增运营位 → 在后台配置新增字段或在
mac_vod设置推荐等级，同时更新文档以便客户端接入。 - 线上故障排查 → 根据接口定位 Service 中的逻辑（
mobile.service、vod.service等），结合app_config与 Redis 状态排查。