FongMi /TV
开发完全指南

项目概览与架构

FongMi/TV 是一个面向 Android TV 与手机的开源影视 + 直播平台。它本身不内置任何资源，所有内容来自外部「接口」（配置文件 JSON）。直播功能由 ExoPlayer（Media3） + FFmpeg 软解 驱动，支持自动硬解 → 软解降级；点播功能由动态加载的 Spider 驱动，支持 JAR / JS / Python 三种运行时。

技术栈一览

配置文件加载流程

• 1
  加载主配置 JSON

  从用户填写的 URL 拉取 config.json（或 depot.json）。Depot 模式可聚合多个子配置。
• 2
  解析 sites[] + lives[]

  点播站点写入 sites[]，直播源写入 lives[]。两者可以共存。
• 3
  下载并缓存 Spider

  App 按需下载顶层 spider（JAR/JS/PY），及各站点独立的 jar 文件，缓存在本地。
• 4
  实例化 Spider 并调用接口方法

  用户访问站点首页 → homeContent() ；点击分类 → categoryContent() ；点击视频 → detailContent() + playerContent() 。

主配置文件骨架

无论是直播还是点播，入口都是唯一一个主配置 JSON 文件。以下是包含所有顶层字段的最小可用骨架：

{
  // ── 全局 Spider 包（所有 type=3/1/2 站点默认使用）
  "spider": "https://cdn.example.com/spider.jar",

  // ── 点播站点列表 → 详见"点播配置"页
  "sites": [
    {
      "key": "demo", "name": "演示站",
      "type": 3, "api": "csp_Demo"
    }
  ],

  // ── 直播源列表 → 详见"直播配置"页
  "lives": [
    {
      "name": "默认直播",
      "url":  "https://cdn.example.com/live.m3u",
      "epg":  "https://epg.example.com/e.xml"
    }
  ],

  // ── 解析器列表 → 详见"点播配置"页 parses[] 章节
  "parses": [
    { "name": "通用解析", "type": 1, "url": "https://jx.example.com/?url=" }
  ],

  // ── 触发解析器的 URL 关键词
  "flags": ["youku.com", "iqiyi.com", "bilibili.com"],

  // ── 广告 URL 黑名单关键词
  "ads": ["ad.example.com"],

  // ── URL 重写规则
  "rules": [{ "regex": "\\bhttp://", "replace": "https://" }],

  // ── 全局 EPG
  "epg": "https://epg.example.com/all.xml",

  // ── 壁纸 / 公告
  "wallpaper": "https://cdn.example.com/bg.jpg",
  "notice":    "2026-01-01 更新"
}