EPG Tidak Dimuat? Panduan Lengkap untuk Membaiki Panduan TV IPTV Anda pada 2026

Anda sudah menyediakan pemain IPTV anda. Saluran dimuatkan. Anda boleh bertukar antara saluran. Semuanya kelihatan baik — sehinggalah anda membuka panduan TV dan mendapati tiada apa-apa selain deretan sel kosong. Atau lebih teruk lagi: sel yang memaparkan rancangan yang salah, termasuk program yang tamat lima tahun lalu.

Masalah EPG ialah aduan IPTV kedua paling banyak dilaporkan selepas penimbalan, dan perkara yang mengecewakan ialah simptomnya kelihatan sama tanpa mengira puncanya. Panduan ini menerangkan lima masalah sebenar di sebalik EPG yang rosak, mengikut susunan yang wajar diperiksa.

Apa Sebenarnya EPG

EPG ialah singkatan bagi Panduan Program Elektronik. Ia merupakan metadata yang memberitahu pemain IPTV anda perkara yang sedang disiarkan pada setiap saluran, perkara yang akan ditayangkan seterusnya dan penerangan program. Tiada apa-apa yang misteri — pemain anda memuat turun fail atau membuat pertanyaan kepada API, menghuraikan tajuk dan waktu program, kemudian memaparkannya dalam grid di sebelah saluran anda.

Format standardnya ialah XMLTV: satu fail XML yang menyenaraikan setiap saluran, setiap program, setiap waktu mula, setiap tempoh, serta poster dan penerangan jika ada. Fail XMLTV biasa untuk penyedia besar boleh berukuran 50–500 MB tanpa dimampatkan dan mengandungi ratusan ribu entri program.

Sebab EPG kerap rosak ialah fail ini perlu:

1. Berjaya dimuat turun daripada penyedia anda.
2. Dinyahmampatkan dengan betul (kebanyakannya menggunakan gzip).
3. Dihuraikan tanpa ralat.
4. Memadankan ID saluran dalam senarai main anda — di sinilah kebanyakan kegagalan berlaku.
5. Dipaparkan dalam grid pemain anda tanpa tamat masa.

Kegagalan pada mana-mana daripada lima langkah ini akan menyebabkan panduan TV anda kosong. Mari kita lihat satu demi satu.

Pepijat yang pernah saya lepaskan dan kemudian jejaki sendiri (supaya anda boleh mengenalinya dalam pemain anda sendiri): binaan awal Tuneline menyimpan EPG yang telah dihuraikan dalam memori dan tidak membatalkannya apabila pengguna bertukar antara sumber Xtream. Simptomnya: panduan kelihatan penuh, tetapi tajuk program adalah untuk saluran penyedia sebelumnya. Jika anda memasang semula atau memaksa penyegaran dan panduan yang betul muncul, ini ialah jenis pepijat tersebut — dan ia sangat biasa berlaku pada pemain yang menggunakan cache secara agresif tanpa mengasingkan cache mengikut sumber.

---

Punca 1: URL EPG Anda Sudah Tidak Sah atau Tiada

Ini ialah punca yang paling biasa dan paling mudah dibaiki. Jika anda menggunakan senarai main M3U, EPG anda datang daripada URL XMLTV berasingan yang perlu dimasukkan secara manual dalam pemain anda. Ramai pengguna sama ada:

• Tidak pernah memasukkan URL EPG langsung (M3U mempunyai saluran tetapi tiada sumber panduan).
• Memasukkan URL EPG beberapa bulan lalu yang kemudiannya tidak lagi tersedia.
• Memasukkan URL yang salah — panduan untuk senarai saluran penyedia lain.

Cara membaikinya

Cari halaman dokumentasi penyedia anda. Hampir setiap penyedia IPTV berbayar menerbitkan URL M3U dan URL XMLTV. Biasanya formatnya kelihatan seperti ini:

http://your-provider.example/xmltv.php?username=USER&password=PASS

Atau:

http://your-provider.example/epg.xml.gz

Tampalkan ini ke dalam tetapan EPG pemain anda, paksa penyegaran dan lihat panduan dipaparkan. Dalam Tuneline, tetapan ini berada di Tetapan → EPG → URL XMLTV, dengan butang penyegaran di sebelahnya, dan panduan biasanya dipaparkan dalam beberapa saat selepas disegarkan.

Jika anda menggunakan Xtream Codes, biasanya anda tidak perlu menetapkan URL EPG langsung — EPG datang melalui API yang sama seperti saluran. Jika panduan anda kosong dalam Xtream, teruskan ke Punca 3.

---

Punca 2: EPG Telah Dimuat Turun tetapi ID Saluran Tidak Sepadan

Ini ialah kegagalan EPG yang paling mengecewakan kerana ia kelihatan seolah-olah EPG berjaya — pemain anda menyatakan bahawa ia berjaya dimuatkan — tetapi grid masih kosong.

Apa yang berlaku: fail XMLTV anda mengandungi ribuan saluran, setiap satunya dikenal pasti melalui tvg-id seperti news.us atau sport.de. Senarai main M3U anda mempunyai nilai tvg-id tersendiri. Jika ID tersebut tidak sepadan, pemain tidak dapat memautkan program kepada salurannya. Hasilnya ialah EPG yang dimuatkan sepenuhnya tetapi tidak berguna kerana tiada apa-apa yang tersambung.

Cara mengenal pastinya

Lihat entri salah satu saluran dalam fail M3U anda. Barisnya akan kelihatan seperti ini:

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Sekarang lihat fail XMLTV anda (kebanyakan penyedia membenarkan anda memuat turunnya secara terus). Cari ID saluran tersebut. Adakah terdapat entri <channel id="cnn.us"> yang sepadan? Jika tiada — atau jika ID itu sedikit berbeza (contohnya, CNN.us berbanding cnn.us) — itulah masalahnya.

Cara membaikinya

Terdapat beberapa pilihan, bergantung pada pemain anda:

• Pembaikan terbaik: Gunakan pemain yang menyokong padanan kabur — iaitu menggunakan padanan saluran berdasarkan nama yang dinormalkan apabila tvg-id tiada atau penggunaan huruf besarnya tidak sepadan. Pemadan Tuneline menukarkan kedua-dua belah kepada huruf kecil, membuang akhiran biasa seperti "HD"/"FHD"/"4K" serta kod rantau di hujung, kemudian merapikan ruang kosong sebelum membuat perbandingan. Ia tidak sempurna (dua saluran yang sememangnya mempunyai nama sama akan bertindih), tetapi dapat menyelamatkan 70–80% senarai main yang ID penyedianya sekadar tidak kemas.
• Pembaikan manual: Edit fail M3U anda dan ubah nilai tvg-id supaya sepadan dengan fail XMLTV. Cara ini leceh tetapi berkesan.
• Pembaikan oleh penyedia: E-mel penyedia IPTV anda dan beritahu mereka bahawa ID M3U dan ID XMLTV mereka tidak sepadan. Anehnya, mereka kerap menjana semula fail tersebut — aduan ini memang sering diterima.

---

Punca 3: Pelayan EPG Penyedia Anda Perlahan atau Mengehadkan Kadar Permintaan

Fail XMLTV yang besar memang mengambil masa untuk dimuat turun. Jika pelayan EPG penyedia anda terlebih beban (perkara yang sangat biasa pada waktu puncak), pemain anda mungkin tamat masa sebelum muat turun selesai. Sesetengah penyedia turut mengehadkan kadar muat turun EPG — jika anda telah menyegarkan EPG lima kali dalam sejam terakhir, permintaan seterusnya mungkin digugurkan secara senyap.

Simptom

• EPG kadangkala dimuatkan, tetapi tidak setiap masa.
• Penyegaran pertama selepas pemasangan berjaya, kemudian penyegaran berikutnya kembali kosong.
• EPG berfungsi pada pukul 3 pagi tetapi gagal pada pukul 8 malam.

Cara membaikinya

• Tingkatkan tempoh masa tamat EPG dalam pemain anda. Kebanyakan pemain menetapkannya kepada 30 saat secara lalai. Tingkatkannya kepada 120 saat.
• Kurangkan kekerapan penyegaran EPG. Sekali setiap 12 atau 24 jam sudah mencukupi untuk data program langsung.
• Gunakan versi gzip. Jika penyedia anda menyediakan epg.xml dan epg.xml.gz, sentiasa gunakan URL gzip — saiznya biasanya 5–10 kali lebih kecil.
• Jika penyedia mengehadkan kadar permintaan, tunggu sejam. Kemudian segarkan dan jangan segarkan lagi selama sehari.

---

Punca 4: Fail XMLTV Anda Rosak

Eksport XMLTV sesetengah penyedia mengandungi entri yang tidak sah — format tarikh tidak sah, aksara UTF-8 yang rosak dan tag yang tidak ditutup. Penghurai XML yang ketat akan enggan memuatkan keseluruhan fail hanya kerana satu entri rosak, lalu menyebabkan EPG anda kosong.

Cara mengenal pastinya

Jika log pemain anda (setiap pemain yang serius memilikinya) memaparkan ralat seperti "Ralat penghuraian XML pada baris 47291" atau "penghujung input yang tidak dijangka," anda telah berdepan fail yang rosak.

Cara membaikinya

Secara umumnya, anda mempunyai tiga pilihan:

• Gunakan pemain yang lebih bertolak ansur. Sesetengah pemain (termasuk Tuneline) dikonfigurasikan untuk melangkau entri yang tidak sah dan memuatkan entri yang lain. Pemain yang ketat akan menghentikan pemuatan keseluruhan fail.
• Gunakan sumber EPG yang berbeza. Banyak agregator EPG awam percuma menerbitkan semula data penyedia dengan pemformatan yang lebih bersih. Berhati-hati dengan syarat lesen.
• Laporkan fail yang rosak kepada penyedia anda. Biasanya mereka boleh membaikinya dalam masa sehari.

---

Punca 5: Pemain Anda Sememangnya Tidak Cekap Memaparkan EPG Besar

Sesetengah pemain mendakwa menyokong EPG tetapi tersekat apabila grid mempunyai lebih daripada beberapa ratus saluran. Data tersedia dan penghuraian berjaya, tetapi antara muka sama ada terhenti atau memaparkan sel kosong kerana memaparkan ribuan entri program secara serentak terlalu perlahan.

Simptom

• Menatal EPG terasa lambat.
• Sel muncul dan hilang semasa anda menatal.
• 50 saluran pertama memaparkan program tetapi semua saluran selepas itu kosong.

Cara membaikinya

Ini ialah batasan pemain. Pilihan pembaikannya ialah:

• Gunakan pemain dengan pemaparan EPG tervirtualisasi. Pemain moden hanya memaparkan sel yang benar-benar kelihatan, jadi panduan 5,000 saluran ditatal sepantas panduan 50 saluran. Tuneline's EPG grid is virtualized and tested on 10,000+ channel playlists — panduan besar tidak sepatutnya membuatkan pengalaman menonton TV anda terasa perlahan.
• Tapis senarai saluran anda. Jika anda hanya kerap menonton 30 saluran, sembunyikan yang lain. EPG dipaparkan jauh lebih pantas pada senarai yang lebih kecil.
• Tukar pemain. Ini selalunya jawapan yang tepat jika anda sudah berbulan-bulan bergelut dengan EPG.

---

Urutan Diagnosis yang Menjimatkan Masa

Apabila seseorang bertanya kepada kami, "mengapa EPG saya tidak dimuatkan," kami membimbing mereka mengikut urutan ini:

1. Adakah URL EPG telah dikonfigurasi? (Jika menggunakan M3U.) Kebanyakan pengguna melangkau langkah ini.
2. Adakah URL itu masih berfungsi? Bukanya dalam pelayar — anda sepatutnya melihat XML atau menerima muat turun.
3. Adakah ID saluran dalam M3U sepadan dengan ID dalam XMLTV? Pilih satu saluran dan sahkannya secara manual.
4. Adakah pelayan EPG penyedia anda responsif sekarang? Cuba muat semula pada waktu yang berbeza.
5. Bolehkah fail XMLTV dihuraikan? Semak log pemain untuk melihat ralat penghuraian.
6. Bolehkah pemain anda mengendalikan saiz panduan ini? Cuba subset yang lebih kecil.

Jika anda menyemak semuanya secara sistematik, anda akan menemui puncanya setiap kali.

---

Rupa Sebenar "EPG yang Baik"

Inilah standard yang patut anda harapkan daripada pemain IPTV anda:

• Pemuatan pertama < 60 saat untuk panduan 200 MB melalui Wi-Fi.
• Muat semula di latar belakang tanpa mengganggu main balik.
• Padanan ID kabur supaya senarai main yang sedikit tidak sepadan masih boleh dipautkan.
• Bar Kini/Seterusnya yang menunjukkan rancangan yang sedang disiarkan dan rancangan seterusnya tanpa membuka grid penuh.
• Cari merentas EPG — cari "pukul berapa perlawanan itu disiarkan?" tanpa menatal.
• Peringatan — beri saya amaran apabila rancangan tertentu akan bermula.
• Integrasi catch-up — mengklik rancangan yang disiarkan 3 jam lalu akan memainkan versi catch-up jika penyedia anda menyokongnya.

Jika pemain semasa anda tidak menyediakan kebanyakan ciri ini, itu bukan perkara biasa. Ini petanda pemain anda ketinggalan daripada teknologi terkini.

---

Soalan Lazim

Mengapa EPG saya memaparkan rancangan lama dari bertahun-tahun lalu?

Fail XMLTV anda sudah lapuk. Pemain anda memuat turun panduan sekali dan tidak pernah memuat semulanya. Paksa muat semula secara manual, kemudian pastikan muat semula automatik didayakan mengikut jadual harian.

Mengapa EPG berfungsi untuk sesetengah saluran tetapi tidak untuk saluran lain?

Hampir selalu ini masalah padanan tvg-id (Punca 2). Saluran yang mempunyai EPG mempunyai ID yang sepadan dengan fail XMLTV; saluran yang tiada EPG tidak sepadan.

Adakah terdapat sumber EPG awam percuma yang boleh saya gunakan?

Ya — projek seperti iptv-org/epg menyelenggara eksport XMLTV pilihan komuniti untuk banyak negara. Kualitinya berbeza-beza. Sumber ini paling sesuai sebagai pelengkap kepada EPG penyedia anda, bukan pengganti.

Adakah Tuneline mempunyai sokongan EPG yang lebih baik berbanding pemain IPTV lama?

Kami membina sokongan EPG khusus kerana setiap pemain lain yang kami cuba gagal menangani salah satu daripada lima punca di atas. Tuneline menyediakan padanan ID kabur, pemaparan grid tervirtualisasi, muat semula di latar belakang, carian, peringatan dan integrasi catch-up jika disokong. Tiada satu pun daripadanya ajaib — inilah fungsi yang sepatutnya ada pada panduan TV pada tahun 2026.

Berapa kerapkah saya perlu memuat semula EPG saya?

Sekali sehari sudah memadai untuk data rancangan langsung. Kebanyakan penyedia mengemas kini XMLTV mereka sekali atau dua kali sehari. Memuat semula setiap 15 minit tidak akan memberikan data yang lebih baharu — ia hanya akan membebankan penyedia anda dan berkemungkinan menyebabkan anda dikenakan had kadar.

---

Ringkasnya

Masalah EPG kelihatan misteri tetapi hampir selalu berpunca daripada salah satu daripada lima isu yang boleh dibaiki: URL tiada, ID saluran tidak sepadan, penyedia perlahan, fail rosak atau pemaparan pemain yang lemah. Semak semuanya mengikut urutan dan anda akan membaiki panduan tersebut dalam masa kurang daripada sejam.

Jika anda sudah bosan menghadapi gangguan EPG yang sama setiap beberapa minggu, cuba Tuneline — padanan ID kabur, pemaparan tervirtualisasi dan muat semula di latar belakang tersedia secara standard. Panduan anda sepatutnya berfungsi begitu sahaja.