Tất cả hướng dẫn

Khắc phục sự cố EPG

Lịch phát sóng trống hoặc sai: khắc phục sự cố M3U và XMLTV

Cách chẩn đoán có phương pháp khi thiếu chương trình, lệch giờ hoặc chương trình bị gắn nhầm kênh.

Được đội ngũ kỹ thuật DringTV biên soạn và kiểm chứng · Cập nhật ngày 1 tháng 8 năm 2026 · 8 phút đọc

Trả lời nhanh

Một EPG chính xác cần đủ ba mắt xích: nguồn XMLTV truy cập được, cùng một mã định danh kênh trong danh sách phát và tệp XMLTV, và xử lý giờ đúng. Hãy kiểm tra lần lượt từng mức theo thứ tự đó thay vì làm mới ứng dụng liên tục.

Ý chính

  • Luồng phát và dữ liệu chương trình là hai tài nguyên độc lập.
  • tvg-id trong danh sách phát phải khớp với id kênh trong XMLTV.
  • Nếu mọi chương trình đều lệch cùng một khoảng thời gian, nguyên nhân thường là múi giờ hoặc độ lệch giờ (offset).
  • Không bao giờ đăng URL XMLTV riêng tư lên diễn đàn hay trong ảnh chụp màn hình.
01

Ba mắt xích của lịch phát sóng

Danh sách phát mô tả các mục nội dung. XMLTV mô tả các kênh và chương trình của chúng. Trình phát phải ghép hai phía qua một mã định danh ổn định, rồi quy đổi giờ chương trình theo múi giờ của thiết bị.

Chỉ dựa vào tên hiển thị là không đủ. Hai tên khác nhau vẫn có thể khớp nhờ cùng một id kỹ thuật, trong khi hai tên giống hệt nhau vẫn có thể không khớp nếu id khác nhau.

02

Chẩn đoán trong năm phút

  1. Xác nhận mục nội dung phát được; nếu không, EPG chưa phải vấn đề cần xử lý đầu tiên.
  2. Kiểm tra danh sách phát có khai báo lịch phát sóng qua url-tvg hay không, hoặc chủ sở hữu nguồn có cấp riêng một URL XMLTV hợp lệ hay không.
  3. Chỉ kiểm tra tên miền của URL trên trình duyệt, không để lộ toàn bộ địa chỉ riêng tư hay các tham số.
  4. Làm mới danh sách phát và lịch phát sóng, rồi chờ quá trình đồng bộ hoàn tất.
  5. So sánh một tvg-id trong danh sách phát với id kênh tương ứng trong XMLTV.
03

Đọc đúng triệu chứng

Triệu chứngNguyên nhân có thểCách kiểm tra
Không có chương trình nàoXMLTV bị thiếu, không truy cập được hoặc trốngĐịa chỉ đã khai báo, trạng thái mạng, kích thước tệp và ngày tháng
Chỉ một số mục bị trốngtvg-id bị thiếu hoặc không khớpMã định danh có khớp chính xác không
Mọi chương trình đều lệch giờLỗi múi giờ hoặc độ lệch giờ của nguồnGiờ trong XMLTV, múi giờ thiết bị và giờ mùa hè
Chương trình hiện ở nhầm mụcÁnh xạ trùng lặp hoặc saiCác giá trị id kênh và tvg-id là duy nhất
Lịch trống sau vài ngàyXMLTV không còn được cập nhật hoặc bộ nhớ đệm đã hết hạnNgày của chương trình cuối cùng và tần suất làm mới
04

Trình phát sửa được gì và không sửa được gì

Trình phát có thể tải xuống, lưu đệm, lập chỉ mục và hiển thị dữ liệu nhận được. Nó có thể suy đoán một số cặp khớp theo tên, nhưng suy đoán có thể ghép nhầm hai kênh khác nhau.

Trình phát không thể tự tạo ra chương trình bị thiếu hay sửa vĩnh viễn các id không nhất quán của nguồn. Cách khắc phục đáng tin cậy là để quản trị viên hợp pháp của nguồn sửa danh sách phát hoặc tệp XMLTV.

05

Thông tin cần có trong một báo cáo lỗi hữu ích

  • Loại nguồn: M3U, Xtream Codes hoặc Stalker/Ministra.
  • Số mục bị ảnh hưởng (ước lượng), không để lộ nội dung riêng tư.
  • Khoảng lệch giờ quan sát được và múi giờ của thiết bị.
  • Phiên bản ứng dụng và kiểu máy thiết bị.
  • Thời điểm làm mới thành công gần nhất.
  • Không bao giờ kèm URL, mật khẩu, token, MAC hay ảnh chụp màn hình có thông tin đăng nhập.

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

Tại sao vẫn phát được dù không có lịch phát sóng?

Địa chỉ phát và dữ liệu chương trình là hai tài nguyên riêng biệt. Một bên có thể vẫn hoạt động trong khi bên kia bị thiếu hoặc đã hết hạn.

Đổi múi giờ trên TV có luôn sửa được lỗi lệch giờ không?

Chỉ khi múi giờ của thiết bị bị sai. Nếu giờ trong XMLTV được mã hóa sai, dữ liệu nguồn phải được sửa.

Tài liệu tham khảo kỹ thuật

Áp dụng các nguyên tắc này trên giao diện thiết kế cho TV

Bảng giá · Trang chủ