海洋CMS短剧模块怎么用？短剧采集与播放设置

海洋CMS 短剧不需要单独安装模块，短剧就是一类普通视频数据：建一个「短剧」分类、把带短剧资源的资源站 API 绑进「资源库」并采集、把播放组指向支持 m3u8 的播放器再套竖屏模板，三件事做完就能上线。

海洋CMS 短剧模块在哪里？要先建分类吗？

结论：短剧的入口是后台「视频 → 分类管理」，先建一个短剧分类，再去接采集，顺序不能反。

具体做法：后台 → 视频 → 分类管理 → 添加分类，分类名填「短剧」，拼音填 duanju，排序填一个靠前的数字（比如 5）让它出现在导航里。分类建完后，短剧的列表页、详情页、导航都会自动生成，不需要改数据库。

如果资源站返回的数据里短剧是独立分类（分类名带「短剧」或「都市爽剧」这类关键词），采集时直接映射到 duanju；如果资源站把短剧塞进「连续剧」或「其他」里，就用采集设置里的分类绑定功能做一次映射，否则短剧会和长剧混在同一个列表里。

海洋CMS 短剧采集怎么配？资源站接口怎么填？

结论：短剧采集和普通视频采集是同一套「资源库采集」，差别只在分类映射和播放地址格式。

步骤：

1. 后台 → 采集 → 资源库（部分版本显示为「采集资源」），新增一条资源站记录，接口地址填资源站提供的 API，典型形式是 https://资源站域名/api.php/provide/vod/。
2. 保存后点「测试」，系统会自动在接口后面拼上 ?ac=list 拉分类列表，能返回 JSON 或 XML 才算接通。
3. 拉详情用 ac=detail，分页参数 pg=1 开始递增，h=24 表示只拉最近 24 小时更新的数据，日常定时更新用这个参数最省资源。
4. 只补某几部剧时用 ids=xxx 精确指定，比翻页快得多。
5. 采集完去「视频 → 内容管理」按短剧分类筛一次，检查播放地址字段，格式通常是 第1集$https://xxx/1.m3u8#第2集$https://xxx/2.m3u8，用 $ 分隔集名和地址、# 分隔集数。

注意点：一部短剧 80-100 集、每集 1-3 分钟，单次采集的数据量比长视频大，把采集每页条数控制在 20 以内，单次采集的剧集数控制在 50 部以内，避免 PHP 执行超时导致采到一半断掉。

海洋CMS 短剧播放怎么设置？为什么采完点开不能播？

结论：短剧能不能播，取决于采集回来的播放地址前缀有没有映射到一个支持 m3u8/HLS 的播放组。

排查顺序：

1. 后台 → 系统 → 播放器管理（播放组），确认存在一个播放组，名称可以叫 m3u8，播放器代码指向 DPlayer、Artplayer 或自定义 HLS 播放器。
2. 回到采集设置，把资源站返回的播放地址前缀（常见是 m3u8、duanju、youku）映射到上面这个播放组。没做映射，前台会渲染出一个空白播放器或提示无法播放。
3. 播放器代码必须支持 m3u8 直链。HLS 是分片流，Chrome、Edge 的 <video> 标签不能直接播，要靠 hls.js；Safari 和 iOS 原生支持，所以 PC 端能播不代表手机端一定正常，两端都要测。
4. 播放页模板里输出播放器的标签沿用你当前版本自带播放页模板的写法，改模板前先备份原文件。

短剧前台样式要改哪些地方？

结论：短剧和长视频的差异在比例和集数，改模板比改程序有效。

封面比例：列表页封面容器改成 aspect-ratio: 3/4，手机端一屏放 2 列，PC 端放 4-6 列。短剧封面是竖图，用 16:9 的容器会裁掉大半张脸。

播放器容器：最大宽度限制在 480px 以内并居中，竖屏视频在电脑上全宽播放会变成中间一条细缝。

选集控件：短剧集数长，把选集做成 1-100 的网格加翻页，比横向滚动条好用——用户点第 87 集不用滑半天。同时把「上一集/下一集」按钮放在播放器正下方，短剧的连播率靠这两个按钮撑。

整体流程就是：建短剧分类 → 绑资源站 API → 采集中把短剧分类和 m3u8 播放组映射好 → 模板改竖屏比例和选集网格。四步里最容易漏的是播放组映射和 hls.js，采完播不了先查这两处，再回头看采集数据里播放地址字段是不是空的。