Mayk IP TV

Tài liệu kỹ thuật

Quy cách định dạng danh sách phát M3U

Đặc tả kỹ thuật định dạng danh sách phát M3U cho IPTV. Tìm hiểu các thẻ Cấp 1 và Cấp 2, phân tích cú pháp kênh và kiểm tra tương tác.

Giới thiệu định dạng M3U trong Mayk IP TV

Định dạng danh sách phát M3U là tiêu chuẩn toàn cầu cho danh sách kênh IPTV. Mayk IP TV hỗ trợ hoàn hảo cả tệp M3U truyền thống và tệp M3U8 hiện đại có siêu dữ liệu phong phú.

Cấu trúc và cú pháp của danh sách phát

Một tệp M3U hợp lệ luôn bắt đầu bằng dòng khai báo #EXTM3U, theo sau là các cặp dòng siêu dữ liệu #EXTINF tuần tự và liên kết luồng phát trực tiếp.

Phân loại nội dung VOD và phim bộ

Nội dung video được tự động phân loại thành truyền hình trực tiếp, phim lẻ hoặc tập phim bộ dựa trên các mẫu chỉ định mùa như S01 E02.

Thực tiễn tốt nhất khi xử lý tệp tin

Luôn áp dụng bảng mã UTF-8 chuẩn, các liên kết HTTP/HTTPS hoạt động và giá trị tvg-id duy nhất để đảm bảo lịch phát sóng điện tử (EPG) chính xác.

Cấp 1: Các thẻ tiêu chuẩn #EXTINF

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
#EXTM3UTiêu chuẩn (Cấp 1) · Bắt buộcDirective (Header)#EXTM3UDòng tiêu đề bắt buộc xác định tệp là danh sách phát M3U mở rộng hợp lệ.
#EXTINFTiêu chuẩn (Cấp 1) · Bắt buộcDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDChỉ thị thông tin bản nhạc chỉ định thời lượng luồng và các thuộc tính siêu dữ liệu.
tvg-idTiêu chuẩn (Cấp 1) · Tùy chọnStringtrt1.trMã định danh duy nhất liên kết kênh với bản ghi trong tệp lịch phát sóng XMLTV EPG.
tvg-nameTiêu chuẩn (Cấp 1) · Tùy chọnStringTRT 1 HDTên kênh phát sóng chính thức được đăng ký trong hướng dẫn chương trình điện tử.
tvg-logoTiêu chuẩn (Cấp 1) · Tùy chọnURL (http/https)https://stream.example.com:8080/images/trt1.pngĐịa chỉ web trực tiếp tới hình ảnh biểu trưng của kênh (khuyên dùng PNG hoặc SVG qua HTTPS).
group-titleTiêu chuẩn (Cấp 1) · Tùy chọnStringNationalTên nhóm hoặc thể loại mà kênh được phân loại vào trong giao diện trình phát.
#EXTGRP:Tiêu chuẩn (Cấp 1) · Tùy chọnDirective#EXTGRP:NationalChỉ thị nhóm thay thế được đặt ngay sau dòng EXTINF.

Cấp 2: Các thẻ mở rộng Mayk IP TV

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
media-typeMở rộng (Cấp 2) · Tùy chọnEnum ("live" | "movie" | "series")media-type="series"Ghi đè loại phương tiện rõ ràng: 'live', 'movie' hoặc 'series'.
series-idMở rộng (Cấp 2) · Tùy chọnString / Integerseries-id="show-42"Mã định danh phim bộ duy nhất nhóm nhiều luồng tập phim lại với nhau.
series-nameMở rộng (Cấp 2) · Tùy chọnStringseries-name="Example Series"Tên phim truyền hình chuẩn để tập hợp các mùa và danh sách tập phim.
seasonMở rộng (Cấp 2) · Tùy chọnIntegerseason="1"Số mùa cho các tập phim truyền hình nhiều tập (số nguyên).
episodeMở rộng (Cấp 2) · Tùy chọnIntegerepisode="4"Số tập trong mùa phát sóng được chỉ định (số nguyên).
is_adultMở rộng (Cấp 2) · Tùy chọnInteger ("0" | "1")is_adult="1"Cờ khóa phụ huynh: '1' đánh dấu nội dung người lớn hoặc bị giới hạn.
age_ratingMở rộng (Cấp 2) · Tùy chọnStringage_rating="18+"Huy hiệu xếp hạng độ tuổi tối thiểu (ví dụ: '18+') cho bộ lọc kiểm soát.

Quy tắc phân loại nội dung

Loại#Giá trị mẫu
Truyền hình trực tiếp#3http(s)://... | media-type="live"
Phim lẻ (VOD)#2/movie/... | media-type="movie"
Tập phim bộ#1/series/... + S01E01 / S01.E01 | media-type="series"

Mẫu đoạn mã

Truyền hình trực tiếp (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
Phim lẻ (VOD) & Tập phim bộ (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

Công cụ kiểm tra định dạng tương tác

Dán đoạn mã M3U hoặc phản hồi JSON Xtream bên dưới để kiểm tra tính tương thích với Mayk IP TV.

Danh sách kiểm tra tương thích M3U

  • Đảm bảo dòng đầu tiên của tệp tin chính xác là chuỗi ký tự #EXTM3U.
  • Thiết lập giá trị thời lượng là -1 cho tất cả các kênh truyền hình trực tiếp.
  • Gán các giá trị tvg-id hợp lệ tương ứng với nguồn dữ liệu XMLTV của bạn.
  • Nhóm các kênh hợp lý bằng cách sử dụng thuộc tính group-title.
  • Lưu tệp tin dưới bảng mã UTF-8 thuần túy không có ký hiệu thứ tự byte (BOM).