空壳影视

外观

MacCMS对接空壳影视 ​

将自建的MacCMS站点配置为空壳影视的数据源，实现自有资源的影视点播功能。

前提条件 ​

获取接口地址 ​

MacCMS的API接口地址为：

https://你的域名/api.php/provide/vod/

例如：https://www.example.com/api.php/provide/vod/

测试接口

将接口地址复制到浏览器中访问，如果返回JSON数据则说明接口正常。

注意

资源站的接口类型需选择 MacCMS V10 或 苹果V10
一般MacCMS首页默认就是此格式。

获取播放源名称 ​

访问接口地址后，在返回的JSON数据中找到 vod_play_from 字段：

json
"vod_play_from":"m3u8,iframe"

该字段包含所有播放源名称，多个播放源以逗号分隔。

优化接口地址 ​

为了减少返回数据量、提高加载速度，可以通过 from 参数指定播放源：

原来：https://www.example.com/api.php/provide/vod/
优化：https://www.example.com/api.php/provide/vod/from/m3u8/

将 vod_play_from 的值加到URL末尾，APP只返回该播放源的数据。

完整配置示例 ​

json
{
  "privateKey": "404",
  
  "tvSources": [
    {
      "name": "IPTV",
      "m3uUrl": "https://example.com/tv.m3u",
      "block": false
    }
  ],
  
  "sources": [
    {
      "name": "我的MacCMS",
      "url": "https://www.example.com/api.php/provide/vod/from/m3u8/",
      
      "playerName": {
        "m3u8": "默认"
      },
      
      "blockTypeName": [
        "伦理片",
        "韩国伦理",
        "港台三级",
        "两性课堂",
        "写真热舞"
      ],
      
      "blockAdsRule": [],
      
      "desc": "自建MacCMS资源站"
    }
  ]
}

字段详细说明 ​

privateKey（隐私码） ​

json
"privateKey": "404"

隐私码用于控制非常规资源的访问权限。输入隐私码后才能查看被屏蔽的分类。

sources（影视点播源） ​

json
"sources": [
  {
    "name": "源名称",
    "url": "接口地址",
    "playerName": {},
    "blockTypeName": [],
    "blockAdsRule": [],
    "typeConfig": {},
    "desc": "描述"
  }
]
字段必填说明
name是显示在APP中的源名称
url是MacCMS接口地址
playerName否播放器别名配置
blockTypeName否需屏蔽的分类名称
blockAdsRule否广告过滤正则规则
typeConfig否一级分类转二级分类
desc否源描述信息

playerName（播放器别名） ​

json
"playerName": {
  "m3u8": "默认",
  "iframe": "备用"
}

vod_play_from 的值与显示别名的映射，用于在APP中显示更友好的名称。

blockTypeName（屏蔽分类） ​

json
"blockTypeName": [
  "伦理片",
  "韩国伦理",
  "港台三级",
  "新闻资讯"
]

需要屏蔽的分类名称，对应数据库中 type_name 字段的值。输入隐私码后，被屏蔽的分类会显示出来。

提示

建议将非常规分类放入屏蔽列表，默认隐藏，需要时通过隐私码访问。

typeConfig（分类配置） ​

json
"typeConfig": {
  "电影": [
    "动作片",
    "喜剧片",
    "爱情片",
    "科幻片",
    "恐怖片",
    "剧情片",
    "纪录片",
    "战争片",
    "动画片"
  ],
  "电视剧": [
    "国产剧",
    "欧美剧",
    "韩剧",
    "日剧",
    "港剧",
    "台剧",
    "泰剧"
  ],
  "综艺": [
    "大陆综艺",
    "日韩综艺",
    "港台综艺",
    "欧美综艺"
  ],
  "动漫": [
    "国产动漫",
    "日韩动漫",
    "欧美动漫"
  ]
}

用于一级分类转二级分类。如果你的MacCMS是一级分类（如快车资源站），需要此配置将分类重新组织。

desc（源描述） ​

json
"desc": "自建MacCMS资源站，数据更新及时"

显示在设置界面源列表下方的描述文字。

部署配置文件 ​

方法一：部署到服务器 ​

  1. 将JSON配置保存为 config.json 文件
  2. 上传到服务器（支持HTTPS）
  3. 获取文件访问链接
  4. 在空壳影视中配置该链接

方法二：使用Github托管 ​

  1. 在Github创建仓库
  2. 上传 config.json 文件
  3. 使用CDN加速访问（如 ghproxy.com）

配置地址示例：

https://ghp.ci/https://raw.githubusercontent.com/用户名/仓库名/main/config.json

注意事项 ​

  • 确保MacCMS服务器支持跨域访问（CORS）
  • 建议使用HTTPS协议
  • 接口响应速度影响APP加载体验
  • 所有符号需使用英文半角符号

空壳影视 © Mac-CMS.Com