#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
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ại | Giá trị mẫu | Mô tả |
|---|---|---|---|---|
#EXTM3U | Tiêu chuẩn (Cấp 1) · Bắt buộc | Directive (Header) | #EXTM3U | Dò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ệ. |
#EXTINF | Tiêu chuẩn (Cấp 1) · Bắt buộc | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Chỉ 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-id | Tiêu chuẩn (Cấp 1) · Tùy chọn | String | trt1.tr | Mã đị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-name | Tiêu chuẩn (Cấp 1) · Tùy chọn | String | TRT 1 HD | Tê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-logo | Tiêu chuẩn (Cấp 1) · Tùy chọn | URL (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-title | Tiêu chuẩn (Cấp 1) · Tùy chọn | String | National | Tê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ọn | Directive | #EXTGRP:National | Chỉ 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ại | Giá trị mẫu | Mô tả |
|---|---|---|---|---|
media-type | Mở rộng (Cấp 2) · Tùy chọn | Enum ("live" | "movie" | "series") | media-type="series" | Ghi đè loại phương tiện rõ ràng: 'live', 'movie' hoặc 'series'. |
series-id | Mở rộng (Cấp 2) · Tùy chọn | String / Integer | series-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-name | Mở rộng (Cấp 2) · Tùy chọn | String | series-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. |
season | Mở rộng (Cấp 2) · Tùy chọn | Integer | season="1" | Số mùa cho các tập phim truyền hình nhiều tập (số nguyên). |
episode | Mở rộng (Cấp 2) · Tùy chọn | Integer | episode="4" | Số tập trong mùa phát sóng được chỉ định (số nguyên). |
is_adult | Mở rộng (Cấp 2) · Tùy chọn | Integer ("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_rating | Mở rộng (Cấp 2) · Tùy chọn | String | age_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 | #3 | http(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ã
#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).