IPTV na Apple TV: Ustawienia EPG& Przewodnik po konfiguracji

Jeśli już masz swoje kanały odtwarzające, ale przewodnik programowy jest pusty, błędny lub pokazuje czasy, które są przesunięte o kilka godzin, napotkałeś najczęstszy problem po konfiguracji z IPTV na Apple TV: konfiguracja EPG. Dobrą wiadomością jest to, że prawie zawsze można to naprawić, gdy zrozumiesz, co tak naprawdę dzieje się w tle.

Ten przewodnik przeprowadza przez to, jak działa system przewodnika, jak go poprawnie skonfigurować i jak rozwiązać konkretny problem, który widzisz — czy to pusty przewodnik, niedopasowane listy, czy przewodnik, który znika po dniu.

Czym jest EPG i jak łączy się z Twoją listą odtwarzania IPTV

Największym nieporozumieniem, które widzę, jest to, że ludzie traktują listę kanałów i przewodnik programowy jako jedną rzecz. To nie jest to samo. To dwa całkowicie oddzielne pliki, a aplikacja odtwarzacza Apple TV musi je połączyć samodzielnie.

Lista M3U vs. Przewodnik XMLTV: Dwa oddzielne pliki

Twoja lista odtwarzania M3U (lub M3U8) to po prostu lista strumieni kanałów — jeden URL na kanał, z dołączonymi danymi metadanych. Nie zawiera żadnych danych o harmonogramie. Listy programów pochodzą z oddzielnego pliku XMLTV, który zazwyczaj jest.xml lub skompresowany.xml.gz plik hostowany pod własnym URL. Odtwarzacz pobiera oba, a następnie ustala, jak je połączyć.

To krok łączenia jest miejscem, w którym faktycznie powstaje większość problemów z EPG.

Jak tvg-id mapuje kanały do danych przewodnika

Wewnątrz każdego wpisu kanału w Twoim M3U,#EXTINF linia zawiera atrybuty takie jaktvg-id,tvg-name,tvg-logo, igroup-title. Ten, który ma znaczenie dla dopasowania przewodnika, totvg-id. Odtwarzacz bierze tę wartość i szuka odpowiadającego<channel id="..."> wpisu w pliku XMLTV. Jeśli identyfikatory dokładnie się zgadzają — włącznie z wielkością liter — dołącza harmonogram programu do tego kanału. Jeśli się nie zgadzają, nie dostajesz nic.

To jest rzeczywista przyczyna większości pustych lub niedopasowanych przewodników. Ciąg musi być dokładnym dopasowaniem.CNN icnn to różne rzeczy.CNN.us iCNN są różne. Brak dopasowania fuzzy, brak zapasowego.

Niektóre playlisty używajątvg-name zamiasttvg-id, a niektóre odtwarzacze będą korzystać z dopasowania opartego na nazwie, gdy brak jest identyfikatora. Jednak dopasowanie nazw jest mniej niezawodne i całkowicie zależy od tego, jak dany odtwarzacz to obsługuje. Gdzie tylko to możliwe, chcesz mieć odpowiednietvg-id wartości.

Skąd pochodzi URL EPG

Twój dostawca IPTV zazwyczaj podaje URL XMLTV obok linku M3U — oba są częścią Twoich danych subskrypcyjnych. Czasami sam M3U zawieraurl-tvg lubx-tvg-url tag na początku pliku, który wskazuje na przewodnik. Gdy ten tag jest obecny, niektóre odtwarzacze odbierają go automatycznie. Inne całkowicie go ignorują i wymagają ręcznego wprowadzenia URL. Warto sprawdzić oba.

Krok po kroku: Dodawanie i konfigurowanie EPG w odtwarzaczu IPTV Apple TV

Dokładne nazwy menu różnią się w zależności od aplikacji, ale odtwarzacze IPTV tvOS zasadniczo podążają za tym samym wzorem dla IPTV na Apple TV: konfiguracja EPG. Oto jak wygląda proces w większości z nich.

Wprowadzanie URL XMLTV w ustawieniach odtwarzacza

Otwórz aplikację odtwarzacza i przejdź do Ustawień lub ekranu konfiguracji playlisty.Szukaj pola oznaczonego czymś w stylu "EPG URL", "Guide URL" lub "XMLTV". Wklej tam swój link XMLTV — zazwyczaj jest to długi URL kończący się na.xml lub.xml.gz. Zapisz ustawienia. Odtwarzacz powinien natychmiast rozpocząć pobieranie pliku przewodnika.

Jedna rzecz, na którą warto zwrócić uwagę: jeśli Twój URL XMLTV jest serwowany przez zwykły HTTP zamiast HTTPS, niektóre wersje tvOS zablokują żądanie całkowicie. To samo dotyczytvg-logo URL obrazów — jeśli loga kanałów się nie pojawiają, to często jest powód. Upewnij się, że oba URL używają HTTPS.

Wymuszanie odświeżenia przewodnika i ustawienie interwału automatycznej aktualizacji

Po zapisaniu, większość aplikacji ma przycisk "Odśwież EPG" lub "Aktualizuj przewodnik" gdzieś w ustawieniach. Użyj go. Nie czekaj na automatyczne odświeżenie — potwierdź, że przewodnik ładuje się poprawnie teraz.

Dla interwału automatycznego odświeżania, większość odtwarzaczy pozwala ustawić to na co 6, 12 lub 24 godziny. Trzymaj się 12 lub 24 godzin. Odświeżanie częściej niż to może spowodować, że Twój adres IP zostanie ograniczony lub tymczasowo zablokowany przez hosta XMLTV, co oznacza, że Twój przewodnik cicho przestaje się aktualizować bez pokazywania jakiegokolwiek błędu.

Weryfikacja, czy kanały są dopasowane do wpisów w przewodniku

Po zakończeniu odświeżania, przejdź do kanału, który oczekujesz, że ma dane przewodnika i sprawdź EPG. Jeśli jest pusty, problemem jest prawie na pewnotvg-id niezgodność. Otwórz swój plik M3U w edytorze tekstu na innym urządzeniu i znajdźtvg-id dla tego kanału. Następnie sprawdź plik XMLTV pod kątem<channel id="..."> z tą dokładną wartością. Jeśli występuje jakakolwiek niezgodność, identyfikatory muszą zostać skorygowane u źródła — albo w M3U, albo w XMLTV.

Ustawienie poprawnej strefy czasowej i przesunięcia czasowego

Znaczniki czasowe XMLTV wyglądają jak20260623180000 +0000 — to czas UTC z wyraźnym przesunięciem wbudowanym. Odtwarzacz przekształca to na twój lokalny czas. Jeśli konwersja jest błędna, każda lista przesuwa się o tę samą wartość, zazwyczaj o pełną liczbę godzin.

Najpierw sprawdźUstawienia> Ogólne> Data& Czas na samym Apple TV i upewnij się, że "Ustaw automatycznie" jest włączone. Jeśli strefa czasowa urządzenia jest błędna, każda aplikacja na nim pokaże przesunięte czasy. Po drugie, niektóre odtwarzacze IPTV mają swoje własne oddzielne ustawienie przesunięcia czasowego w konfiguracji EPG — sprawdź pole "+0" lub "przesunięcie UTC" i ustaw je, aby odpowiadało rzeczywistej różnicy strefy czasowej od UTC. Przejścia na czas letni przesuną wszystko o jedną godzinę dwa razy w roku, jeśli aplikacja lub urządzenie nie obsługuje DST automatycznie, więc warto to sprawdzić w marcu i listopadzie.

Naprawianie najczęstszych problemów EPG na Apple TV

Najpierw objaw, potem przyczyna, potem rozwiązanie. To najbardziej użyteczny format do rzeczywistego rozwiązywania problemów.

Przewodnik jest całkowicie pusty

Trzy najbardziej prawdopodobne przyczyny: adres URL XMLTV jest błędny lub wygasł, plik jest skompresowany gzipem i odtwarzacz nie może go dekompresować, lub żadne ztvg-id wartości w twoim M3U nie pasują do niczego w XMLTV. Sprawdź najpierw adres URL — wklej go bezpośrednio do przeglądarki na innym urządzeniu i potwierdź, że zwraca dane. Jeśli otrzymasz.xml.gz plik, którego twój odtwarzacz nie obsługuje, musisz znaleźć nieskompresowaną wersję tego samego przewodnika lub przełączyć się na odtwarzacz, który obsługuje gzip natywnie.

Programy są przesunięte o kilka godzin

Prawie zawsze jest to problem ze strefą czasową. Zweryfikuj strefę czasową systemu Apple TV w Ustawieniach> Ogólne> Data& Czas, a następnie sprawdź własne ustawienie przesunięcia czasowego odtwarzacza. Jeśli przewodnik konsekwentnie pokazuje wszystko przesunięte o dokładnie 5 godzin, na przykład, gdzieś występuje niezgodność UTC-5. Najpierw napraw strefę czasową urządzenia, a następnie przesunięcie odtwarzacza, jeśli to jest oddzielne ustawienie.

Właściwy kanał, błędne dane programu

To jest interesujące. Jeśli kanał pokazuje harmonogram, ale jest to oczywiście błędny — na przykład kanał sportowy pokazujący harmonogram wiadomości — prawdopodobnie masztvg-id kolizję. Dwa różne kanały w twoim M3U dzielą to samotvg-id, a odtwarzacz dopasował jeden do danych przewodnika przeznaczonych dla drugiego. Naprawa wymaga edytowania M3U, aby przypisać unikalne, poprawne identyfikatory. Nie możesz tego zrobić z Apple TV.

Niektóre kanały mają przewodnik, inne nie

Kanały, które nie mają danych przewodnika, albo nie majątvg-id w M3U, mają identyfikator, który nie pasuje do niczego w XMLTV, albo te konkretne kanały po prostu nie są uwzględnione w źródle XMLTV, które dostarcza twój dostawca. Sprawdź M3U dla brakujących kanałów i porównajtvg-id wartości z listą kanałów w pliku XMLTV. Kanały regionalne lub mniej popularne są często całkowicie pomijane w źródłach przewodników.

Przewodnik ładuje się, a następnie znika po dniu

Większość plików XMLTV zawiera tylko 2–7 dni danych do przodu. Jeśli plik dostarcza tylko 24–48 godzin, a automatyczne odświeżanie nie działa, skończysz z danymi przewodnika. Sprawdź, czy automatyczne odświeżanie jest włączone w ustawieniach odtwarzacza i potwierdź, że adres URL XMLTV nadal zwraca świeże dane. Niektóre odtwarzacze również czyszczą swoją pamięć podręczną przewodnika, gdy aplikacja jest całkowicie zamknięta; jeśli tak się dzieje, ręczne odświeżenie przy następnym uruchomieniu jest rozwiązaniem.

Jakość danych EPG, okno pokrycia i pamięć na Apple TV

Zrozumienie technicznych ograniczeń formatu przewodnika pomaga ustawić realistyczne oczekiwania — i wyjaśnia niektóre zachowania, które w przeciwnym razie wyglądają jak błąd.

Ile dni danych przewodnika pliki XMLTV zazwyczaj zawierają

Standardowe pliki XMLTV obejmują 2 do 7 dni programowania do przodu. Niektórzy dostawcy oferują przewodniki 14-dniowe dla niektórych regionów. Poza oknem pokrycia przewodnik po prostu nic nie pokazuje — nie jest to błąd, po prostu puste. To oczekiwane zachowanie, a nie błędna konfiguracja.

Rozmiar pliku, kompresja gzip i limity pamięci na starszym Apple TV HD

Plik XMLTV z wielu regionów obejmujący setki kanałów może łatwo osiągnąć 50–100 MB w formacie niekompresowanym. Apple TV HD (starszy model z chipem A8) ma 1 GB pamięci RAM współdzielonej przez wszystko, co oznacza, że bardzo duże pliki przewodników mogą powodować wolne ładowanie, awarie lub ciche błędy. Apple TV 4K radzi sobie z tym znacznie lepiej.

Jeśli korzystasz z Apple TV HD, preferuj przewodniki skompresowane gzip (.xml.gz) — zazwyczaj są one 5–10 razy mniejsze w transmisji. Jeśli twój dostawca oferuje przewodnik specyficzny dla regionu zamiast globalnego, użyj tego zamiast pełnego pliku z wielu regionów. To najłatwiejszy sposób na skrócenie czasu pobierania i zmniejszenie obciążenia pamięci.

Flagi Catch-Up / Archiwum i jak pojawiają się w przewodniku

Niektóre playlisty M3U zawierają atrybuty takie jakcatchup="default",catchup-sourcelubtimeshiftw wpisach kanałów. Gdy odtwarzacz obsługuje te atrybuty, wyświetla przycisk "przewiń wstecz" lub "zacznij od nowa" w interfejsie przewodnika dla przeszłych programów. Nie wszystkie odtwarzacze tvOS implementują funkcję catch-up, a wymaga to zarówno wsparcia po stronie serwera, jak i odpowiednich flag M3U — posiadanie samego atrybutu nie sprawia, że to działa, jeśli strumień tego nie obsługuje.

Logotypy, opisy i metadane kategorii

Logotypy kanałów pochodzą ztvg-logoURL w M3U. Opisy programów i kategorie pochodzą z samego pliku XMLTV, zazwyczaj wewnątrz<desc>i<category>tagów dla każdego programu. Jeśli logotypy się nie ładują, upewnij się, że adresy URL są HTTPS. Jeśli opisy są nieobecne w przewodniku, to dostawca XMLTV ich nie uwzględnia — odtwarzacz może pokazać tylko to, co jest w pliku.

Co nie działa (i dlaczego)

Kilka rzeczy konsekwentnie myli ludzi, gdy zarządzają IPTV na Apple TV: konfiguracja EPG, która wydaje się poprawna, ale nie działa zgodnie z oczekiwaniami.

Oczekiwanie, że przewodnik naprawi uszkodzony strumień kanału

EPG to metadane. Informuje, co powinno być na kanale — nie ma żadnego wpływu na to, czy strumień faktycznie odtwarza. Kanał, który buforuje, przerywa lub zwraca czarny ekran, ma problem na poziomie strumienia. Naprawa przewodnika nie pomoże. To są całkowicie oddzielne systemy.

Używanie przewodnika z innego źródła kanałów

Ogólny plik XMLTV z agregatora EPG trzeciej strony nie będzie pasował do twojej playlisty, chyba żetvg-idwartości w twoim M3U zostały specjalnie ustawione, aby pasowały do identyfikatorów kanałów tego agregatora. Większość czasu tak nie było, więc otrzymujesz pusty przewodnik, mimo że oba pliki są technicznie poprawne. Źródło XMLTV musi pasować do identyfikatorów kanałów w twoim konkretnym M3U. Nie ma obejścia tego problemu po stronie Apple TV.

Ręczna edycja przewodnika na samej Apple TV

tvOS nie daje ci możliwości ręcznej edycji wpisów przewodnika, ponownego mapowania identyfikatorów kanałów ani nadpisywania pojedynczych listingów. Wszystko musi być poprawione w górę — w pliku M3U lub źródle XMLTV. Jeśli kanał ma błędne dane przewodnika, ta poprawka musi nastąpić przed dotarciem plików do Apple TV. Żaden odtwarzacz na tvOS nie oferuje funkcji edycji przewodnika; to nie jest ograniczenie konkretnej aplikacji, to po prostu sposób, w jaki działa platforma.