围绕ckplayer播放器生态做配套,是ck资源(别名:ck资源站、ck采集接口)在采集圈里被反复提及的特点。其接口输出兼顾常见的资源形态,播放端只要配置得当,整体对接成本并不高。本词条从接口地址格式、参数含义、配置要点到常见播放问题逐一记录,并附别名变体与适用程序说明,供建站者备查。
基本信息
| 词条名 | ck资源 |
|---|---|
| 别名变体 | ck资源站、ck采集接口 |
| 接口类型 | 影视CMS通用格式采集接口 |
| 数据格式 | JSON与XML双格式输出 |
| 常见资源形态 | m3u8切片与mp4直链混合 |
| 适用CMS | 苹果CMS V10、飞飞CMS等支持通用接口的程序 |
| 更新频率评价 | 更新中规中矩,主打稳定而非量大 |
| 资源清晰度评价 | 清晰度分层较明显,标注与实际基本相符 |
接口地址格式
ck资源的接口路径写法为 http://你的域名/api.php/provide/vod/,真实地址以资源方公布为准。与其他源相比,它的接入重点不在取数而在播放端:列表与详情请求都是标准写法,取回的播放地址字段则要确认格式类型,再在后台绑定对应的播放器。播放端黑屏、卡顿类问题的系统化排查方法,可参阅苹果CMS播放器问题排查手册:黑屏、卡顿、不自动连播。以下是三个格式示例。
http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?ac=detail&ids=1
http://你的域名/api.php/provide/vod/?at=xml
参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作参数,list与detail二选一 | ac=list |
| at | 格式开关,取xml时输出XML结构 | at=xml |
| ids | 编号参数,配合detail取单条或多条数据 | ids=3 |
| pg | 页码参数,列表翻页时递增 | pg=1 |
| h | 时间参数,筛选最近N小时内更新的条目 | h=24 |
| t | 分类参数,限定单一分类输出 | t=1 |
| wd | 搜索参数,按片名关键词匹配 | wd=示例 |
配置要点
- 播放器先于采集:接入前先在后台确认m3u8与mp4对应的播放器均已安装并启用,缺哪类先补哪类。
- 绑定到来源:把播放器与采集来源正确绑定,采集入库时才能自动套用,省去前台逐条调整。
- 混合格式抽检:同一批数据里切片与直链并存,抽检两类地址各播放一遍,确认均可正常加载。
- 增量定时:常规定时任务即可覆盖日常更新,频率不必激进,稳定优先于速度。
- 冗余校验:对取回的地址做非空与协议头校验,提前过滤残缺数据,减少前台报错来源。
常见问题
采集成功但前台播放黑屏,一般是哪个环节出了问题?
采集成功只说明数据进了库,黑屏多发生在播放链路上:常见原因是播放器未绑定到该采集来源、地址格式与播放器类型不匹配,或模板调用的播放器参数有误。逐项核对绑定关系与格式对应,再清缓存复测。
播放器绑定选错了,已入库的数据需要重新采集吗?
多数情况不必重采。播放器绑定调整后,可在后台对既有数据批量刷新播放器字段,保存后再验证播放;只有当地址数据本身残缺或格式无法识别时,才需要针对对应批次重新采集。
切片与直链两种地址,采集配置上有区别吗?
取数环节没有区别,差别在播放器:切片地址依赖对应格式的播放器解析,直链地址则要求播放器支持相应协议。建议按格式分别绑定播放器,并在抽检时两种地址各测一轮,避免只验证其中一类。