海洋 CMS 如何新增自定义播放器解析接口

海洋CMS 新增自定义播放器解析接口，本质上就是三件事：在后台「播放器管理」里加一条播放器记录（名称 + 编码 + 解析接口地址），把这条记录启用，然后让影片的播放地址前缀对上这个编码。下面按顺序讲清楚每一步和几个最容易踩的坑。

海洋CMS 新增自定义播放器解析接口的步骤是什么

结论：后台「系统」→「播放器管理」→「添加播放器」，填好名称、编码、解析地址并启用，是标准做法；不同版本菜单名可能叫「播放器设置」或「播放器列表」，位置都在系统设置区域。

具体操作：

1. 登录后台，进「系统」菜单，找到「播放器管理」（部分 v7/v9 版本叫「播放器设置」）。
2. 点「添加播放器」，填写三项核心内容：播放器名称（前台显示的名字，如「XX 解析」）、播放器编码（英文标识，如 xxjx）、播放器地址／解析接口（如 https://jx.example.com/?url=）。
3. 播放器类型选择「解析」或「远程解析」（选成「直链」的话，系统会直接把地址丢给播放器，不会去调接口）。
4. 状态设为「启用」，排序值填小一点让它排在前面，保存。
5. 清一次后台缓存（系统 → 缓存管理／更新缓存），否则前台播放器列表可能还是旧的。

播放器的「编码」和「解析地址」该怎么填

结论：编码是前台播放地址和后台配置之间的唯一对应关系，一旦定了就不要改；解析地址必须写成「接口前缀 + 视频原始地址」能拼通的完整形式。

解析接口常见有三种写法，填之前先用浏览器手动验证：

• 拼接式：https://jx.example.com/?url=，播放时实际请求 https://jx.example.com/?url=https://v.qq.com/x/cover/xxx.html
• 占位符式：https://jx.example.com/jx.php?url={url}，部分接口文档会明确要求 {url} 占位
• 带鉴权式：https://jx.example.com/?token=你的token&url=，token 直接写在地址里

如果原始视频地址里带 & 参数（比如 ?id=1&type=2），拼接后会被解析接口当成自己的参数截断，这时需要对视频地址做 URL 编码（& → %26、: → %3A），写成 https%3A%2F%2F... 再拼。

再看播放数据本身：海洋CMS 的播放地址存在影片表的播放字段里，格式是「播放器编码$$$第1集$地址#第2集$地址」。也就是说，采集或手动编辑影片时，如果播放地址前缀写的是 xxjx$$$...，而后台播放器编码填的是 xxjx2，前台就会显示不出这个播放器——编码必须逐字符一致，大小写敏感。

解析接口配好了前台不播放，怎么排查

结论：90% 的问题出在混合内容拦截、编码不匹配、缓存未更新这三处，按顺序查最快。

1. 先单独测接口：把「解析地址 + 一个真实视频地址」直接粘到浏览器地址栏打开，能出播放画面说明接口没问题，问题在 CMS 配置；打不开说明接口本身挂了或被墙。
2. 查 HTTPS 混合内容：如果站点是 https://，而解析接口是 http://，Chrome、Edge 会直接拦截 iframe 加载，控制台报 Mixed Content。解决办法是换支持 HTTPS 的解析接口，或者给接口套一层反向代理。
3. 查编码一致性和启用状态：后台播放器列表里该条必须「启用」，且影片播放地址前缀与编码完全一致。
4. 清缓存 + 换浏览器无痕测试：海洋CMS 前台有静态缓存，改完配置不清缓存很容易以为没生效。
5. 看接口是否校验 Referer：部分解析接口只允许白名单域名调用，需要在接口后台把本站域名加进去，或在请求头里带 Referer。

不通过后台、直接改数据库行不行

结论：可以，但只建议在后台没有对应菜单的老版本上做，且必须先备份数据库。

海洋CMS 的播放器配置最终落在数据库的播放器表里（不同版本表名略有差异，常见为 sea_play 一类，操作前先按后台实际表结构和字段核对）。操作流程是：先备份该表 → 参照已有记录复制一行 → 修改名称、编码、地址、状态字段 → 保存 → 后台清缓存。风险在于字段含义依赖具体版本，填错状态位会出现「播放器存在但前台不显示」，所以能用后台就用后台。

另外一个实用技巧：把常用解析接口做成 2–3 个播放器（比如「解析线路1」「解析线路2」），同一个影片挂两组地址，主线路挂了用户可以自己切换，比只有一个解析源稳得多。

总结一下：新增自定义解析播放器 = 后台加记录（名称 + 编码 + 解析接口 + 解析类型 + 启用）+ 播放地址前缀对齐编码 + 清缓存；不生效时优先查 HTTPS 混合内容和编码大小写，再测接口本身是否可用。