feat: 添加 TVBox 配置接口，支持视频源导入及解析功能
This commit is contained in:
katelya
+175
@@ -0,0 +1,175 @@
|
||||
# TVBox 配置接口使用指南
|
||||
|
||||
## 📺 功能介绍
|
||||
|
||||
KatelyaTV 现在支持 TVBox 配置接口，可以将您的视频源直接导入到 TVBox 应用中使用。这个功能会自动同步 KatelyaTV 中配置的所有视频源，并提供标准的 TVBox JSON 格式配置。
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 1. 访问配置页面
|
||||
|
||||
在 KatelyaTV 网站中，点击左侧导航栏的"TVBox 配置"菜单，或直接访问：
|
||||
|
||||
```
|
||||
https://your-domain.com/tvbox
|
||||
```
|
||||
|
||||
### 2. 复制配置链接
|
||||
|
||||
选择以下任一配置格式：
|
||||
|
||||
**JSON 格式（推荐）：**
|
||||
|
||||
```
|
||||
https://your-domain.com/api/tvbox
|
||||
```
|
||||
|
||||
**Base64 格式：**
|
||||
|
||||
```
|
||||
https://your-domain.com/api/tvbox?format=txt
|
||||
```
|
||||
|
||||
### 3. 导入到 TVBox
|
||||
|
||||
1. 打开 TVBox 应用
|
||||
2. 进入设置 → 配置地址
|
||||
3. 粘贴复制的配置链接
|
||||
4. 点击确认导入
|
||||
|
||||
## 🔧 配置说明
|
||||
|
||||
### 支持的功能
|
||||
|
||||
- ✅ 自动同步 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 格式配置
|
||||
- `txt`：返回 Base64 编码的配置
|
||||
|
||||
**响应：**
|
||||
|
||||
```json
|
||||
{
|
||||
"sites": [...], // 影视源列表
|
||||
"parses": [...], // 解析源列表
|
||||
"flags": [...], // 播放标识
|
||||
"ads": [...], // 广告过滤规则
|
||||
"wallpaper": "...", // 壁纸地址
|
||||
"lives": [...] // 直播源（可选）
|
||||
}
|
||||
```
|
||||
|
||||
### 视频解析接口
|
||||
|
||||
**GET** `/api/parse`
|
||||
|
||||
**参数：**
|
||||
|
||||
- `url`: 视频地址
|
||||
- `parser`: 解析器名称（可选）
|
||||
- `format`: 返回格式（可选）
|
||||
|
||||
**响应：**
|
||||
|
||||
```json
|
||||
{
|
||||
"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 及其衍生应用。_
|
||||
Reference in New Issue
Block a user