Mayk IP TV

技術參考手冊

M3U 播放清單格式規格

適用於 IPTV 之完整 M3U 播放清單格式規格技術手冊。深入認識第 1 層與第 2 層標籤、頻道解析判別規則,並透過線上互動工具驗證清單相容性。

Mayk IP TV 中的 M3U 格式規格導論

M3U 播放清單格式乃是全球 IPTV 頻道串聯之重要基準。Mayk IP TV 完整支援傳統 M3U 檔案,以及具備豐富中繼資料之現代 M3U8 格式。

播放清單之結構與語法架構

一份規範之 M3U 檔案一律以 #EXTM3U 宣告行起始,緊接著成對排列之 #EXTINF 中繼資料行與直連串流播放網址。

隨選電影與電視影集分類體系

系統將依據如 S01 E02 等季別與集數命名標準,自動將內容歸類為即時電視、隨選電影或電視影集單集。

清單解析之最佳實踐原則

務必採用純淨之 UTF-8 編碼、連線穩定之 HTTP/HTTPS 直連網址,並賦予專屬之 tvg-id 數值以確保電子節目表 (EPG) 正確對齊。

第 1 層: 標準 #EXTINF 標籤

欄位 / 標籤層級類型範例值說明
#EXTM3U標準 (第 1 層) · 必填Directive (Header)#EXTM3U必備之標頭宣告行,明確將檔案識別為有效之擴充 M3U 播放清單。
#EXTINF標準 (第 1 層) · 必填Directive (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD用於指定串流播放長度與中繼資料屬性之音訊曲目資訊指令。
tvg-id標準 (第 1 層) · 選填Stringtrt1.tr唯一識別代碼,用於將該頻道精準綁定至 XMLTV EPG 節目時刻表。
tvg-name標準 (第 1 層) · 選填StringTRT 1 HD於電子節目指南 (EPG) 資料庫中所登記之官方頻道正式名稱。
tvg-logo標準 (第 1 層) · 選填URL (http/https)https://stream.example.com:8080/images/trt1.png指向頻道台標圖示之直接網路位址(強烈建議經由 HTTPS 傳輸 PNG 或 SVG)。
group-title標準 (第 1 層) · 選填StringNational在播放器介面選單中,為該頻道劃分歸類之所屬群組分類名稱。
#EXTGRP:標準 (第 1 層) · 選填Directive#EXTGRP:National緊接於 EXTINF 行之後的備用分類群組宣告指令。

第 2 層: Mayk IP TV 擴充標籤

欄位 / 標籤層級類型範例值說明
media-type擴充 (第 2 層) · 選填Enum ("live" | "movie" | "series")media-type="series"明確覆寫媒體類型之標籤:'live'、'movie' 或 'series'。
series-id擴充 (第 2 層) · 選填String / Integerseries-id="show-42"將多個劇集單集串流匯聚於同一影集之下的專屬唯一識別碼。
series-name擴充 (第 2 層) · 選填Stringseries-name="Example Series"用於整合季度與各集次播放軌道之電視影集正式名稱。
season擴充 (第 2 層) · 選填Integerseason="1"電視連續影集單集所隸屬之季別數字編號(整數)。
episode擴充 (第 2 層) · 選填Integerepisode="4"指定季別內部之單集集數數字編號(整數)。
is_adult擴充 (第 2 層) · 選填Integer ("0" | "1")is_adult="1"家長控制保護鎖定旗標:'1' 標示為成人限制級內容。
age_rating擴充 (第 2 層) · 選填Stringage_rating="18+"供家長監護過濾機制使用之最低年齡分級標籤(例如 '18+')。

內容分類與判別規則

類別#範例值
即時電視#3http(s)://... | media-type="live"
電影 (VOD)#2/movie/... | media-type="movie"
影集單集#1/series/... + S01E01 / S01.E01 | media-type="series"

範例範本

即時電視 (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
電影 (VOD) & 影集單集 (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4

互動式格式驗證器

請在下方貼上您的 M3U 代碼片段或 Xtream JSON 回應,以確認與 Mayk IP TV 之相容性。

M3U 相容性規範查核清單

  • 請再三確認檔案最起始之第一行字元完全符合 #EXTM3U。
  • 針對所有無間斷播送之即時電視頻道,將長度固定設為 -1。
  • 設定能與 XMLTV 節目來源精準匹配之有效 tvg-id 欄位值。
  • 善加運用 group-title 屬性將繁雜頻道妥善歸類於不同群組。
  • 存檔時請選用無 BOM (位元組順序記號) 之標準 UTF-8 編碼。