mirror of https://github.com/FongMi/TV.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
352 lines
13 KiB
352 lines
13 KiB
# 直播來源格式說明
|
|
|
|
LiveParser 依內容自動偵測格式，支援三種直播來源：
|
|
|
|
| 格式 | 判斷條件 |
|
|
|--------------------|-------------------------------|
|
|
| [JSON](#json-陣列格式) | 內容為 JSON（`[` 開頭） |
|
|
| [M3U](#m3u-格式) | 任一行含 `#EXTM3U`（且不含 `#genre#`） |
|
|
| [TXT](#txt-格式) | 其他 |
|
|
|
|
---
|
|
|
|
## 目錄
|
|
|
|
- [TXT 格式](#txt-格式)
|
|
- [M3U 格式](#m3u-格式)
|
|
- [JSON 陣列格式](#json-陣列格式)
|
|
- [頻道指令](#頻道指令)
|
|
- [DRM 宣告](#drm-宣告)
|
|
- [追看/時移](#追看時移)
|
|
|
|
---
|
|
|
|
## TXT 格式
|
|
|
|
每行以逗號 `,` 分為兩欄。含 `#genre#` 的行宣告分組，含 `://` 的行為頻道。
|
|
|
|
```
|
|
分組名稱,#genre#
|
|
頻道名稱,播放URL
|
|
```
|
|
|
|
**行的解析規則：**
|
|
|
|
| 行的形式 | 說明 |
|
|
|------------------|---------------------------------|
|
|
| `名稱,#genre#` | 宣告新分組，後續頻道歸入此分組 |
|
|
| `名稱,URL` | 頻道項目（第二欄含 `://`） |
|
|
| `名稱_密碼,#genre#` | 建立密碼保護的隱藏分組 |
|
|
| 不含 `://` 的行 | 頻道[指令行](#頻道指令)，作用至下一個 `#genre#` |
|
|
| 首個頻道前無 `#genre#` | 自動建立無名預設分組 |
|
|
|
|
**多線路備援**：以 `#` 分隔多個 URL，播放器依序嘗試：
|
|
|
|
```
|
|
CCTV1,http://cdn1.example.com/cctv1.m3u8#http://cdn2.example.com/cctv1.m3u8
|
|
```
|
|
|
|
**行內標頭**：URL 後接 `|key=value`，多個以 `&` 連接，多線路時每段各自帶標頭：
|
|
|
|
```
|
|
CCTV1,http://cdn1.example.com/cctv1.m3u8|User-Agent=okhttp#http://cdn2.example.com/cctv1.m3u8|Referer=https://example.com/
|
|
```
|
|
|
|
**範例：**
|
|
|
|
```
|
|
新聞台,#genre#
|
|
CCTV1,http://cdn1.example.com/cctv1.m3u8#http://cdn2.example.com/cctv1.m3u8
|
|
鳳凰資訊,http://example.com/phoenix.m3u8|User-Agent=Mozilla/5.0
|
|
|
|
體育台,#genre#
|
|
ua=Mozilla/5.0
|
|
referer=https://sports.example.com/
|
|
CCTV5,http://example.com/cctv5.m3u8
|
|
CCTV5+,http://example.com/cctv5plus.m3u8
|
|
|
|
電影台,#genre#
|
|
header={"Authorization":"Bearer token123"}
|
|
HBO,http://example.com/hbo.m3u8
|
|
|
|
成人_secretpass,#genre#
|
|
某頻道,http://example.com/adult.m3u8
|
|
```
|
|
|
|
---
|
|
|
|
## M3U 格式
|
|
|
|
以 `#EXTM3U` 開頭，每個頻道由 `#EXTINF:` 行與其後的 URL 行組成，中間可插入任意指令行。
|
|
|
|
```m3u
|
|
#EXTM3U [全域屬性...]
|
|
#EXTINF:-1 [頻道屬性...],頻道顯示名稱
|
|
[選用指令行...]
|
|
http://example.com/stream.m3u8[|行內標頭]
|
|
```
|
|
|
|
### `#EXTM3U` 全域屬性
|
|
|
|
| 屬性 | 說明 |
|
|
|-----------------------|------------------------------------------|
|
|
| `tvg-url="…"` | XMLTV EPG 節目表 URL（僅當 Live 配置未設定 EPG 時生效） |
|
|
| `url-tvg="…"` | 同 `tvg-url`，備用寫法（同上條件） |
|
|
| `catchup="…"` | 全域預設追看類型 |
|
|
| `catchup-source="…"` | 全域追看 URL 模板 |
|
|
| `catchup-replace="…"` | 全域追看 URL 替換字串 |
|
|
|
|
```m3u
|
|
#EXTM3U tvg-url="https://epg.example.com/xmltv.xml" catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"
|
|
```
|
|
|
|
### `#EXTINF` 頻道屬性
|
|
|
|
屬性寫在逗號前，頻道顯示名稱寫在逗號後至行尾。
|
|
|
|
| 屬性 | 說明 |
|
|
|-----------------------|--------------------|
|
|
| `tvg-id="…"` | EPG 頻道 ID |
|
|
| `tvg-name="…"` | EPG 頻道名稱（可與顯示名稱不同） |
|
|
| `tvg-chno="…"` | 頻道號碼 |
|
|
| `tvg-logo="…"` | 頻道 Logo URL |
|
|
| `group-title="…"` | 所屬分組名稱 |
|
|
| `http-user-agent="…"` | 播放請求 User-Agent |
|
|
| `catchup="…"` | 此頻道追看類型，覆蓋全域設定 |
|
|
| `catchup-source="…"` | 此頻道追看 URL 模板 |
|
|
| `catchup-replace="…"` | 此頻道追看替換字串 |
|
|
|
|
```m3u
|
|
#EXTINF:-1 tvg-id="CCTV1" tvg-name="CCTV-1" tvg-chno="1" tvg-logo="https://example.com/logo/cctv1.png" group-title="央視",CCTV-1
|
|
```
|
|
|
|
### M3U 專屬指令行
|
|
|
|
在 `#EXTINF:` 與 URL 行之間插入，作用於緊接的下一個 URL（[通用指令](#頻道指令)同樣適用）。
|
|
|
|
| 指令 | 說明 |
|
|
|--------------------------------|--------------------------------|
|
|
| `#EXTHTTP:{"Key":"Value"}` | JSON 格式 HTTP 標頭 |
|
|
| `#EXTVLCOPT:http-user-agent=…` | VLC 風格 User-Agent |
|
|
| `#EXTVLCOPT:http-referrer=…` | VLC 風格 Referer |
|
|
| `#EXTVLCOPT:http-origin=…` | VLC 風格 Origin |
|
|
| `#KODIPROP:…` | DRM 與媒體格式，詳見 [DRM 宣告](#drm-宣告) |
|
|
|
|
**行內標頭**：URL 末接 `|key=value&key2=value2`：
|
|
|
|
```m3u
|
|
http://example.com/stream.m3u8|User-Agent=Mozilla/5.0&Referer=https://example.com/
|
|
```
|
|
|
|
**範例：**
|
|
|
|
```m3u
|
|
#EXTM3U tvg-url="https://epg.example.com/xmltv.xml.gz" catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"
|
|
|
|
#EXTINF:-1 tvg-id="CCTV1" tvg-chno="1" tvg-logo="https://example.com/logo/cctv1.png" group-title="央視",CCTV-1
|
|
http://cdn1.example.com/cctv1.m3u8
|
|
|
|
#EXTINF:-1 tvg-id="CCTV5" group-title="央視",CCTV-5 體育
|
|
#EXTVLCOPT:http-user-agent=Mozilla/5.0
|
|
#EXTVLCOPT:http-referrer=https://sports.example.com/
|
|
http://cdn1.example.com/cctv5.m3u8|User-Agent=Mozilla/5.0
|
|
|
|
#EXTINF:-1 group-title="加密頻道",Premium HD
|
|
#KODIPROP:inputstream.adaptive.license_type=widevine
|
|
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0
|
|
format=mpd
|
|
http://example.com/premium.mpd
|
|
|
|
#EXTINF:-1 group-title="加密頻道",PlayReady 頻道
|
|
#KODIPROP:inputstream.adaptive.drm_legacy=playready|https://license.example.com/playready
|
|
http://example.com/playready.mpd
|
|
|
|
#EXTINF:-1 group-title="一般頻道",需解析頻道
|
|
parse=1
|
|
click=https://example.com/click
|
|
http://example.com/parse-needed.m3u8
|
|
|
|
#EXTINF:-1 group-title="帶標頭頻道",自訂標頭
|
|
#EXTHTTP:{"Authorization":"Bearer mytoken","X-Custom":"value"}
|
|
http://example.com/auth-stream.m3u8
|
|
```
|
|
|
|
---
|
|
|
|
## JSON 陣列格式
|
|
|
|
內容以 `[` 開頭時，直接反序列化為 `List<Group>`，結構與 Live 配置的 `groups` 欄位相同。
|
|
|
|
```json
|
|
[
|
|
{
|
|
"name": "新聞台",
|
|
"channel": [
|
|
{
|
|
"name": "TVBS新聞台",
|
|
"urls": [
|
|
"http://cdn1.example.com/tvbs.m3u8",
|
|
"http://cdn2.example.com/tvbs.m3u8"
|
|
],
|
|
"number": "56",
|
|
"logo": "https://example.com/logo/tvbs.png",
|
|
"tvgId": "TVBS",
|
|
"ua": "Mozilla/5.0",
|
|
"catchup": {
|
|
"type": "append",
|
|
"source": "?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"
|
|
}
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"name": "加密頻道",
|
|
"pass": "secretpass",
|
|
"channel": [
|
|
{
|
|
"name": "Premium",
|
|
"urls": [
|
|
"http://example.com/premium.mpd"
|
|
],
|
|
"format": "application/dash+xml",
|
|
"drm": {
|
|
"type": "widevine",
|
|
"key": "https://license.example.com/widevine",
|
|
"header": {
|
|
"User-Agent": "Mozilla/5.0"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
]
|
|
```
|
|
|
|
> 完整欄位定義見 [CONFIG.md — channel 頻道項目](CONFIG.md#channel--頻道項目)。
|
|
|
|
---
|
|
|
|
## 頻道指令
|
|
|
|
以下指令在 **M3U** 與 **TXT** 格式中均適用，寫法完全一致。
|
|
|
|
- **TXT**：指令行寫在頻道行前，作用至下一個 `#genre#`（包含該分組內所有後續頻道及其多線路 URL）。
|
|
- **M3U**：指令行寫在 `#EXTINF:` 與 URL 行之間，僅作用於緊接的下一個 URL（每個 URL 處理後立即清除）。
|
|
|
|
| 指令 | 範例 | 說明 |
|
|
|-------------|--------------------------------|---------------------------------------|
|
|
| `ua=` | `ua=Mozilla/5.0` | 播放請求 User-Agent |
|
|
| `origin=` | `origin=https://example.com` | 請求 Origin 標頭 |
|
|
| `referer=` | `referer=https://example.com/` | 請求 Referer 標頭（`referrer=` 雙 r 寫法同樣接受） |
|
|
| `header=` | `header={"X-Token":"abc"}` | 任意 HTTP 標頭（JSON 格式） |
|
|
| `format=` | `format=mpd` | 強制指定媒體格式 |
|
|
| `parse=` | `parse=1` | `1` = 需透過解析器處理此 URL |
|
|
| `click=` | `click=https://example.com/c` | 點擊攔截處理 URL |
|
|
| `forceKey=` | `forceKey=true` | 強制使用 DRM 金鑰 |
|
|
|
|
**`format` 可選值：**
|
|
|
|
| 值 | 說明 |
|
|
|----------------|--------------------------------------|
|
|
| `hls` | HLS 串流（`application/x-mpegURL`） |
|
|
| `dash` 或 `mpd` | MPEG-DASH 串流（`application/dash+xml`） |
|
|
|
|
---
|
|
|
|
## DRM 宣告
|
|
|
|
僅 M3U 格式支援，透過 `#KODIPROP:` 行宣告，寫在 `#EXTINF:` 與 URL 行之間。
|
|
|
|
| 指令 | 說明 |
|
|
|-----------------------------------------------------|----------------------------------------------|
|
|
| `#KODIPROP:inputstream.adaptive.license_type=…` | DRM 類型：`widevine` / `playready` / `clearkey` |
|
|
| `#KODIPROP:inputstream.adaptive.license_key=…` | DRM 授權伺服器 URL（或 ClearKey JSON） |
|
|
| `#KODIPROP:inputstream.adaptive.drm_legacy=類型\|URL` | 快速宣告，類型與授權 URL 合一 |
|
|
| `#KODIPROP:inputstream.adaptive.manifest_type=…` | 媒體格式：`mpd` / `dash` / `hls` |
|
|
| `#KODIPROP:inputstream.adaptive.stream_headers=…` | 串流請求標頭（`key=val&key2=val2`） |
|
|
| `#KODIPROP:inputstream.adaptive.common_headers=…` | 通用請求標頭（同上格式） |
|
|
|
|
**授權伺服器標頭**：附加於 `license_key` URL 後，以 `|` 分隔：
|
|
|
|
```m3u
|
|
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0&token=abc
|
|
```
|
|
|
|
**標準寫法（Widevine）：**
|
|
|
|
```m3u
|
|
#EXTINF:-1 group-title="加密頻道",Premium HD
|
|
#KODIPROP:inputstream.adaptive.license_type=widevine
|
|
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0
|
|
format=mpd
|
|
http://example.com/premium.mpd
|
|
```
|
|
|
|
**快速寫法（`drm_legacy`）：**
|
|
|
|
```m3u
|
|
#EXTINF:-1 group-title="加密頻道",PlayReady 頻道
|
|
#KODIPROP:inputstream.adaptive.drm_legacy=playready|https://license.example.com/playready
|
|
http://example.com/playready.mpd
|
|
```
|
|
|
|
**ClearKey（本地 JSON 金鑰）：**
|
|
|
|
```m3u
|
|
#EXTINF:-1 group-title="加密頻道",ClearKey 頻道
|
|
#KODIPROP:inputstream.adaptive.license_type=clearkey
|
|
#KODIPROP:inputstream.adaptive.license_key={"keys":[{"kty":"oct","k":"base64key","kid":"base64kid"}],"type":"temporary"}
|
|
http://example.com/clearkey.mpd
|
|
```
|
|
|
|
**ClearKey（簡短 hex 格式）：** 以 `kid_hex:key_hex` 表示，多對以逗號分隔，框架自動轉換為標準 JSON：
|
|
|
|
```m3u
|
|
#KODIPROP:inputstream.adaptive.license_type=clearkey
|
|
#KODIPROP:inputstream.adaptive.license_key=a7e61c373e219033c21091c302f996c5:100b6c20940f779a4589152b57d2dacb
|
|
http://example.com/clearkey.mpd
|
|
```
|
|
|
|
**`stream_headers` 也支援 `drmScheme` / `drmLicense` 鍵名：**
|
|
|
|
```m3u
|
|
#KODIPROP:inputstream.adaptive.stream_headers=drmScheme=widevine&drmLicense=https://license.example.com/
|
|
```
|
|
|
|
---
|
|
|
|
## 追看/時移
|
|
|
|
在 `#EXTM3U`、`#EXTINF` 或 Live 配置的 `catchup` 欄位中設定，頻道層級設定覆蓋全域。
|
|
|
|
**`type` 可選值：**
|
|
|
|
| 值 | 說明 |
|
|
|-----------|-------------------------------|
|
|
| `append` | 將 `source` 模板附加至原始 URL 末尾（預設） |
|
|
| `default` | 以格式化後的 `source` 完全替換原始 URL |
|
|
|
|
> **PLTV 自動追看**：若頻道未設定任何追看，但播放 URL 含有 `/PLTV/`，框架會自動套用內建的 PLTV 追看設定（`append` 類型，7 天，替換 `/PLTV/` → `/TVOD/`，模板 `?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}`），無需手動設定。
|
|
|
|
**`source` 模板變數：**
|
|
|
|
| 變數 | 說明 | 輸出範例 |
|
|
|------------------------|------------------|------------------|
|
|
| `${(b)yyyyMMddHHmmss}` | 節目開始時間 | `20260312140000` |
|
|
| `${(e)yyyyMMddHHmmss}` | 節目結束時間 | `20260312150000` |
|
|
| `{utc:}` | 節目開始 Unix 時間戳（秒） | `1741780800` |
|
|
| `{utcend:}` | 節目結束 Unix 時間戳（秒） | `1741784400` |
|
|
|
|
**範例（`append` 類型）：**
|
|
|
|
```
|
|
catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"
|
|
```
|
|
|
|
**`catchup-replace` 用途**：
|
|
|
|
組合時移 URL 前，先對原始 URL 執行字串替換。格式為 `原字串,新字串`（逗號分隔）：
|
|
|
|
```
|
|
catchup-replace="/PLTV/,/TVOD/"
|
|
```
|
|
|