AppleCMS 采集接入

采集进来的影片，应该既好看，也好播。 巨量把影片资料与播放方式一起提供：你可以让观众直接使用巨量播放器，也可以保留站点自己的播放器，接入智能 M3U8。

• 两种播放方式，按需选择： 巨量播放器带来多线路、选集和广告屏蔽；智能线路方便接入自己的播放界面。
• 熟悉的后台就能接： 支持 JSON 与 AppleCMS XML，下面备好苹果 CMS、海洋、飞飞与赞片的操作步骤和采集地址。
• 从试采集到自动更新： 先绑定分类与播放器，检查几部影片，再开启定时采集，减少逐条维护。

第一次接入，按「复制地址 → 绑定分类 → 添加播放器 → 试播」走一遍即可。已有 M3U8 片源、只想换播放器的站长，可先看「播放器与备用入口」中的苹果 CMS 教程。

建议： 采集时尽量把海报下载到自己的存储。接口里的图片地址可直接调用，但本地留底能避免后续图源失效。若 XML 偶发解析失败，退出采集列表再重新进入即可。

官方推荐：找资源采集助手

传统采集是每个站各自翻页、逐条入库。官方推荐 找资源采集助手：一台节点采集一次，各站在本机批量写库，之后只同步变化。助手已内置巨量资源。

• 约 38 秒： 每个站点导入全量。
• 约 9 分钟： 接口采集 29 万条。
• 约 10 分钟： 增量一次，全站跟进。

目前已适配苹果 CMS v10。实际耗时受网络、带宽与磁盘影响，以助手官网说明为准。安装与接入见 找资源助手。下面仍是在各 CMS 后台手动填写采集地址的步骤。

采集地址

标准采集根地址：

https://api.juliang.live/api/provide/vod

按用途复制下面的完整地址，填入 CMS 的资源库设置。

综合资源一次返回两个公开播放组。若站点只接智能线路或只接播放器页，请改用带 from 的单组地址，避免采集到未配置的播放来源。

单集剧情与剧照

默认采集结果不含单集剧情和剧照：vod_plot 为 0，vod_plot_name、vod_plot_detail、vod_pic_screenshot 为空，选集名不带单集标题。JSON 接口多季内容保留季集写法，例如「第 2 季 第 1 集」，只有第 1 季的内容直接写「第 N 集」；XML 接口为了让苹果 CMS 入库时不丢集，只有第 1 季时写成「第 N 集」，多季或唯一一季是第 2 季及以后的内容把季集位置放在括号里，例如「第 13 集（第 2 季 第 1 集）」，特别篇写「特别篇」。

站点需要分集剧情、剧照，或希望选集名带上单集标题，可以任选一种方式打开：

• 渠道开关： 请运营为你的渠道打开「单集详情」。打开后，原有采集地址默认包含这些资料，不必改地址。
• 采集地址加 plot=1： 不等后台开关，自己在地址末尾加上即可。

JSON：

https://api.juliang.live/api/provide/vod/?ac=videolist&plot=1

XML：

https://api.juliang.live/api/provide/vod/at/xml/?plot=1
https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/?plot=1
https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/?plot=1

苹果 CMS V10 的接口地址可以直接填带 ?plot=1 的 XML 地址，采集时会用 & 接上分页等参数。其他 CMS 如果不接受带问号的接口地址，请改为请运营打开渠道开关。

渠道已经打开「单集详情」，但某个采集任务只想要精简结果时，在地址中加 plot=0，这次请求就不含单集剧情和剧照。地址里带了 plot 时以地址为准；不带时按渠道开关。

打开后，选集名会带上单集标题，与原有采集结果一致。已采集的影片需要在 CMS 中勾选更新剧情与播放地址，重新采集后才会变化。

已经采集过单集标题的站点请留意：重新采集播放地址时，选集名会跟随当前设置。想保持带标题的选集名，请在地址加 plot=1，或请运营为渠道打开「单集详情」。

公开播放组

采集结果中的智能线路地址如下：

https://jimaoys98.com/public/playback/{token}/smart.m3u8

{token} 随内容与分集变化，不要手工拼接。巨量播放器组返回的是播放页地址，不是 M3U8；智能线路组已经是可播清单，播放器解析地址应留空。

上面是全局 M3U8 地址形态。实际采集结果会按发布渠道、分类和线路使用各自域名；请完整保存接口返回的 URL 与查询参数，不要统一替换域名。

分类映射

首次采集时，请将资源分类对应到自己站点的分类。未绑定的分类不会入库。

暂未提供

苹果 CMS V10

本站 XML 接口可直接加入苹果 CMS V10 自定义资源库。

添加资源库

依次打开【采集】-【自定义资源库】-【添加】，按下面填写后保存。

综合资源：

资源名称：巨量资源综合
接口地址：https://api.juliang.live/api/provide/vod/at/xml/
接口类型：xml
资源类型：视频

只要智能线路：

资源名称：巨量智能线路
接口地址：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
接口类型：xml
资源类型：视频

只要播放器页：

资源名称：巨量播放器
接口地址：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/
接口类型：xml
资源类型：视频

绑定分类

第一次采集会提示绑定分类。请按本页「分类映射」把对方分类对应到自己站点的分类，保存后再执行采集。

添加播放器

采集完成后如果片源没有自动选中，通常是后台还没有对应播放来源。请先按「播放器来源」登记两个公开播放组，再点击右上角【清缓存】。

智能线路已经输出可播 M3U8。若该播放器还填了后台自带解析口，请清空解析地址，否则可能无法播放。

设置自动采集

绑定分类并完成一次小批量采集后，再在采集任务里打开定时。增量窗口建议使用 24 小时，对应接口参数 h=24。宝塔或其他计划任务只需定时访问苹果 CMS 自己的采集入口，不必直接打本站地址。

先在自定义接口列表测试采集，再复制测试链接。

进入【系统】-【定时任务配置】，新增并启用采集任务。

保存后先点击【测试】，确认后台能正常执行。

测试成功后复制任务链接，交给宝塔等外部计划任务调用。

宝塔计划任务建议每 30 分钟执行一次。图中的域名仅为示例，实际填写苹果 CMS 生成的任务链接。

苹果 CMS V8

苹果 CMS V8 通过快捷菜单接入。打开【首页】-【快捷菜单配置】，添加下面三行后保存。flag 只是站点本地标识，可按自己的命名修改。

巨量资源综合,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-apiurl-https://api.juliang.live/api/provide/vod/at/xml/
巨量智能线路,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-smart-apiurl-https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
巨量播放器,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-player-apiurl-https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

绑定分类

进入采集列表后先绑定分类。列表中的两个播放组标识必须与本页公开播放组一致。

设置自动采集

进入【系统】-【定时任务管理】，打开采集任务的修改页面。

保存采集参数前核对 24 小时增量窗口和执行时段。

保存后先测试任务，再复制测试链接。

把苹果 CMS 生成的链接填入宝塔计划任务，建议每 30 分钟执行一次。

点击采集提示 404

部分 V8 后台会把网址参数丢掉。请确认浏览器地址仍包含 admin/index.php?m= 这一段，不要只留下 admin_maccj.php。补回入口后再进入采集列表。

没有选中播放片源

同样需要先添加播放器来源，再清空缓存。播放器标识必须与接口返回的播放组代码完全一致。

海洋 CMS

海洋 CMS 使用兼容 XML 地址。打开【采集】-【资源库管理】，新增资源库：

资源库名称：巨量资源
综合资源：https://api.juliang.live/api/provide/vod/at/xml/
智能线路：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
播放器页：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

部分海洋版本也可以把标准 XML 填进快捷采集：

巨量资源综合,admin_reslib.php?ac=list&rid=&url=https://api.juliang.live/api/provide/vod/at/xml/
巨量智能线路,admin_reslib.php?ac=list&rid=&url=https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/

保存后从【首页】快捷菜单进入资源库列表。若提示暂无播放数据，先按「播放器来源」登记两个公开播放组，再更新缓存。

智能线路不需要额外部署解析包。把解析地址留空，让播放器直接打开接口返回的 M3U8。

飞飞与赞片 CMS

飞飞、赞片与其他兼容苹果 CMS XML 的系统，统一使用综合或单播放组 XML 地址。

综合资源：https://api.juliang.live/api/provide/vod/at/xml/
智能线路：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
播放器页：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

飞飞 CMS

在资源库管理中把接口类型选为 XML，资源类型选视频。采集前先按「播放器来源」登记两个播放器标识，必须与本页公开播放组代码完全一致。

先登记巨量播放器，标识填写本页播放器组代码，独立解析地址留空。

再登记巨量智能线路，标识填写智能线路组代码，独立解析地址同样留空。

飞飞 5.0 若无法采集多组播放地址，确认系统能按 $$$ 拆分播放组、按 # 拆分集数。智能线路组内每一集已是独立 URL，可直接打开播放。

赞片 CMS

赞片 CMS 添加播放器时，名称用「巨量智能线路」「巨量播放器」，标识分别填写本页两个公开播放组代码，解析地址留空。完成后清空缓存，再执行小批量采集。

进入【采集管理】-【资源采集】，点击新增资源。

接口类型选择 XML，资源 URL 填写本页综合或单播放组地址。

进入【内容管理】-【播放器管理】，点击添加。

播放器标识必须与接口返回代码一致，解析地址保持空白。

播放器来源

两个公开播放组都要在你的 CMS 中登记，否则采集结果无法自动选中片源。

标识必须与采集结果里的播放组代码一致，包括大小写。不要填写第三方解析域名去二次包装本站地址。

添加完成后务必清缓存。先抽查一条电影和一条多集内容，分别打开两个播放组，确认可以出画，再放大采集范围。

JSON 接口

移动端、自研程序或使用 JSON 的采集器使用下面两个入口。省略全部参数时，返回第 1 页、默认 20 条，并给出过滤条件下的全部总量。

列表：https://api.juliang.live/api/provide/vod/?ac=list
详情：https://api.juliang.live/api/provide/vod/?ac=detail
XML：https://api.juliang.live/api/provide/vod/at/xml/

调用示例：

https://api.juliang.live/api/provide/vod/?ac=list&pg=1&pagesize=20
https://api.juliang.live/api/provide/vod/?ac=detail&ids=101
https://api.juliang.live/api/provide/vod/at/xml/?ac=detail&h=24
https://api.juliang.live/api/provide/vod/?ac=list&t=1&wd=标题

JSON 使用 page / pagecount / limit / total / list。XML 使用 list 节点上的 page、pagecount、pagesize、recordcount。total 与 recordcount 是过滤后的全部条数，不是当前页长度。

旧数据库字段使用 MySQL utf8mb3 时，无法存储表情和部分生僻字。采集地址加 charset=utf8mb3 后，标题、简介、演员、分类名等文本中的这些字符会转为 HTML 数字实体（如 😀），常用中文与全角符号不变。JSON、XML 都支持，默认仍保留原文；播放字段（含集名）及图片地址保持原样。 完整兼容采集地址（已有 ? 时用 & 追加参数）：

https://api.juliang.live/api/provide/vod/?ac=detail&charset=utf8mb3
https://api.juliang.live/api/provide/vod/at/xml/?charset=utf8mb3

自动采集

先完成分类绑定、播放器登记和少量试采集，再打开定时任务。

推荐节奏：

• 全量：绑定后执行一次，核对分类、海报、集数与双播放组
• 增量：每 15 到 60 分钟采集最近 24 小时，对应 h=24
• 失败：停止批量，保留失败样本，不要连续重放同一错误页

苹果 CMS 定时任务走其后台采集入口。本站增量过滤使用 h，合法范围是 1 到 168 小时。超出范围会返回明确错误，不会自动改为全量采集。

常见问题

采集后没有选中播放片源：后台缺少与播放组代码一致的播放器。补上来源并清缓存。

智能线路无法播放：该组已经是 M3U8，请清空播放器解析口，直接播放返回地址。不要再套一层解析。

只想接一条线路：使用带 from 的单组地址，不要采集综合资源后再手工删组。

分类是空的或不对：先看本页分类映射，完成绑定后再采集。未绑定分类不会进入内容库。

海报能采集但过几天失效：在 CMS 中打开图片本地下载。接口图片地址可调用，本地副本更稳妥。

XML 偶发出错：退出采集列表再进入，或换一页重试。不要把瞬时失败当成接口下线。

播放地址的域名不一样：这是正常情况。请完整保存采集到的地址和参数，不要批量替换域名。播放器备用入口的用法可在帮助中心的「播放器与备用入口」中查看。

未知的 from、超限的 ids 或非法的时间窗口会返回 4xx。请按本页参数表修正后再请求。

接入检查

• 资源库地址使用本页提供的完整地址，接口格式选择正确。
• 已完成分类绑定，播放器标识与采集结果一致。
• 电影能正常播放，多集内容能切换集数和播放组。
• 确认海报与更新状态正常后，再开启定时采集；遇到错误先暂停任务，检查失败地址和提示。