Hướng dẫn EPG IPTV: Cách thêm lịch phát sóng XMLTV vào danh sách phát M3U

EPG (lịch phát sóng điện tử) cho biết chương trình đang phát và sắp phát trên từng kênh. Bài hướng dẫn này giải thích cách danh sách phát IPTV liên kết với lịch XMLTV, lịch phát sóng lấy từ đâu và cách khắc phục khi lịch không hiển thị.

EPG là gì

EPG (lịch phát sóng điện tử) là lịch chương trình TV cho các kênh của bạn: đang phát gì, tiếp theo là gì, và lịch cho vài giờ tới. Trình phát IPTV gần như luôn đọc lịch ở định dạng XMLTV, một tệp XML thuần với hai loại mục:

  • các mục <channel id="…"> đặt tên cho từng kênh trong lịch;
  • các mục <programme start="…" stop="…" channel="…"> chứa tiêu đề, mô tả cùng giờ bắt đầu và kết thúc của mỗi chương trình.

Lịch cho hàng trăm kênh có dung lượng lớn, nên thường được cung cấp ở dạng nén .xml.gz.

Danh sách phát M3U liên kết với lịch như thế nào

Danh sách phát và lịch phát sóng là hai tệp riêng biệt. Chúng được gắn với nhau ở hai chỗ:

  1. Phần đầu danh sách phát chỉ định lịch bằng url-tvg (một số nhà cung cấp viết x-tvg-url). Có thể khai báo nhiều lịch, phân tách bằng dấu phẩy.
  2. Mỗi kênh mang một tvg-id phải trùng với một <channel id> trong lịch. Nhờ đó trình phát biết chương trình nào thuộc về kênh nào.
#EXTM3U url-tvg="https://example.com/guide.xml.gz"
#EXTINF:-1 tvg-id="NewsChannel.us" tvg-logo="https://example.com/news.png" group-title="News",News Channel
https://example.com/live/news/index.m3u8

Nếu tvg-id bị thiếu hoặc viết khác với trong lịch, kênh vẫn phát được nhưng không hiển thị chương trình.

URL EPG lấy từ đâu

  • Nhà cung cấp IPTV của bạn. Hầu hết dịch vụ trả phí công bố URL lịch bên cạnh đường link danh sách phát, hoặc đã ghi sẵn nó trong phần đầu danh sách phát.
  • Lịch cộng đồng cho các kênh công khai. Các dự án mã nguồn mở như iptv-org/epg thu thập lịch chương trình cho các kênh miễn phí (free-to-air) và kênh FAST. Chính các trang kênh của Doubo hiển thị lịch từ i.mjh.nz, nơi phát hành lịch cho các dịch vụ phát trực tuyến miễn phí.
  • Danh sách phát công khai có khai báo lịch. Các danh sách Free-TV và iptv-org trên trang danh sách phát công khai đã có sẵn dòng x-tvg-url, nên lịch của chúng tải lên mà không cần thiết lập gì.

Dùng EPG trong Doubo

Doubo tự động đọc lịch được khai báo trong danh sách phát của bạn. Không có gì phải cấu hình:

  1. Nhập một link hoặc tệp M3U / M3U8 có url-tvg, x-tvg-url hoặc tvg-url ở phần đầu.
  2. Doubo tải lịch XMLTV về (dạng thường hoặc nén gzip), khớp kênh theo tvg-id và lưu bộ nhớ đệm trong sáu giờ.
  3. Mở một kênh: trang trình phát hiển thị chương trình đang phát và các chương trình tiếp theo. Khi danh sách phát cũng khai báo xem lại (catch-up), bạn có thể phát lại các chương trình đã qua ngay từ lịch.

Xem hướng dẫn cài đặt để nhập danh sách phát từng bước.

Khắc phục khi lịch không hiển thị

  • Hoàn toàn không có lịch: mở danh sách phát bằng trình soạn thảo văn bản và tìm url-tvg ở dòng đầu tiên. Nếu không có, hãy hỏi nhà cung cấp URL của lịch.
  • Một số kênh trống lịch: so sánh tvg-id của các kênh đó với id kênh trong lịch. Công cụ M3U cho biết có bao nhiêu mục có tvg-id.
  • Giờ bị lệch: độ lệch múi giờ của lịch không đúng với kênh đó; hãy dùng nguồn lịch khác.
  • Lịch tải chậm: lịch rất lớn sẽ mất một lúc ở lần tải đầu tiên. Hãy ưu tiên lịch .xml.gz, hoặc lịch chỉ bao gồm những quốc gia bạn xem.

Câu hỏi thường gặp

URL EPG là gì?

Đó là địa chỉ của một tệp XMLTV (thường có đuôi .xml hoặc .xml.gz) liệt kê chương trình của nhiều kênh. Danh sách phát trỏ tới tệp này bằng url-tvg hoặc x-tvg-url ở dòng đầu tiên, và trình phát tải tệp về để điền vào lịch.

Vì sao danh sách phát của tôi không có lịch phát sóng?

Thường là do danh sách phát không có dòng url-tvg / x-tvg-url, URL lịch không còn hoạt động, hoặc các kênh không có tvg-id khớp với id kênh trong lịch. Hãy kiểm tra ba điều này trước.

Vì sao giờ trong lịch bị sai?

Thời gian trong XMLTV có kèm độ lệch múi giờ như +0000 hoặc +0800, và trình phát sẽ đổi sang giờ địa phương của bạn. Nếu mọi chương trình đều lệch cùng một số giờ, thì chính tệp lịch đã ghi sai độ lệch. Hãy thử một lịch khác cho kênh đó.

EPG có miễn phí không?

Nhiều lịch là miễn phí. Nhà cung cấp IPTV thường kèm sẵn một lịch trong gói thuê bao, và các dự án cộng đồng phát hành lịch miễn phí cho các kênh công khai. Lịch chỉ mô tả chương trình; nó không cho bạn quyền truy cập bất kỳ kênh nào.