Skip to content

TVBOX.md

Latest commit

 

History

History
191 lines (131 loc) · 4.36 KB

TVBOX.md

File metadata and controls

191 lines (131 loc) · 4.36 KB

TVBox 配置接口使用指南

📺 功能介绍

KatelyaTV 现在支持 TVBox 配置接口，可以将您的视频源直接导入到 TVBox 应用中使用。这个功能会自动同步 KatelyaTV 中配置的所有视频源，并提供标准的 TVBox JSON 格式配置。

🚀 快速开始

1. 访问配置页面

在 KatelyaTV 网站中，点击左侧导航栏的"TVBox 配置"菜单，或直接访问：

https://your-domain.com/config

2. 生成配置链接

在配置页面中：

  1. 选择格式类型：

    • JSON 格式（推荐）：标准的 JSON 配置文件，便于调试和查看
    • Base64 格式：编码后的配置，适合某些特殊环境

  2. 复制配置链接：点击"复制"按钮，系统会自动生成对应格式的配置链接

JSON 格式：

https://your-domain.com/api/tvbox?format=json

Base64 格式：

https://your-domain.com/api/tvbox?format=base64

3. 导入到 TVBox

  1. 打开 TVBox 应用
  2. 进入设置 → 配置地址
  3. 粘贴复制的配置链接
  4. 点击确认导入

🔧 配置说明

🖥️ 配置页面功能

KatelyaTV 提供了直观的 TVBox 配置管理界面：

  • 格式切换：支持 JSON 和 Base64 两种格式切换
  • 一键复制：点击复制按钮快速获取配置链接
  • 实时生成：根据当前网站配置实时生成最新的 TVBox 配置
  • 使用指南：页面内置详细的使用说明和功能介绍

📋 支持的功能

  • ✅ 自动同步 KatelyaTV 的所有视频源
  • ✅ 支持搜索功能
  • ✅ 支持快速搜索
  • ✅ 支持分类筛选
  • ✅ 内置视频解析接口
  • ✅ 广告过滤规则
  • ✅ CORS 跨域支持

内置解析接口

KatelyaTV 提供内置的视频解析服务：

https://your-domain.com/api/parse?url={视频地址}

支持的平台：

  • 腾讯视频 (qq.com)
  • 爱奇艺 (iqiyi.com)
  • 优酷 (youku.com)
  • 芒果 TV (mgtv.com)
  • 哔哩哔哩 (bilibili.com)
  • 搜狐视频 (sohu.com)
  • 乐视 (letv.com)
  • 土豆 (tudou.com)
  • PPTV (pptv.com)
  • 1905 电影网 (1905.com)

解析接口参数

  • url: 要解析的视频地址（必填）
  • parser: 指定解析器名称（可选）
  • format: 返回格式，支持 json、redirect、iframe（可选，默认 json）

📝 API 端点说明

TVBox 配置接口

GET /api/tvbox

参数：

  • format: 返回格式
    • json（默认）：返回 JSON 格式配置
    • base64：返回 Base64 编码的配置

响应：

{
  "sites": [...],      // 影视源列表
  "parses": [...],     // 解析源列表
  "flags": [...],      // 播放标识
  "ads": [...],        // 广告过滤规则
  "wallpaper": "...",  // 壁纸地址
  "lives": [...]       // 直播源（可选）
}

视频解析接口

GET /api/parse

参数：

  • url: 视频地址
  • parser: 解析器名称（可选）
  • format: 返回格式（可选）

响应：

{
  "success": true,
  "data": {
    "original_url": "...",
    "platform": "qq",
    "parse_url": "...",
    "parser_name": "...",
    "available_parsers": [...]
  }
}

🔄 配置更新

当您在 KatelyaTV 中添加、修改或删除视频源时：

  1. TVBox 配置会自动同步最新的源站信息
  2. 在 TVBox 中刷新配置即可获取最新源站
  3. 无需手动更新配置链接

⚠️ 注意事项

  1. 网络要求：确保 TVBox 设备能够访问您的 KatelyaTV 服务器
  2. HTTPS 支持：建议使用 HTTPS 协议确保安全性
  3. 缓存设置：配置会缓存 1 小时，如需立即更新请刷新 TVBox 配置
  4. 兼容性：支持 TVBox 及其衍生应用
  5. 源站限制：解析效果取决于原始视频源的可用性

🛠️ 故障排除

配置导入失败

  • 检查网络连接
  • 确认配置链接格式正确
  • 尝试使用不同的 format 参数

视频无法播放

  • 检查原始视频源是否可用
  • 尝试使用不同的解析器
  • 确认视频平台是否被支持

源站不显示

  • 检查 KatelyaTV 中是否正确配置了视频源
  • 确认视频源格式符合要求
  • 刷新 TVBox 配置

📞 技术支持

如果您在使用过程中遇到问题，请：

  1. 检查上述故障排除方案
  2. 查看 KatelyaTV 和 TVBox 的日志信息
  3. 向项目仓库提交 Issue

此功能基于 TVBox 标准 JSON 配置格式开发，兼容大部分 TVBox 及其衍生应用。