Mayk IP TV

Τεχνική τεκμηρίωση

Προδιαγραφή μορφής λίστας M3U

Πλήρης προδιαγραφή μορφής λίστας αναπαραγωγής M3U για IPTV. Μάθετε τις ετικέτες Επιπέδου 1 και 2, την ανάλυση καναλιών και ελέγξτε λίστες.

Εισαγωγή στη μορφή M3U στο Mayk IP TV

Η μορφή M3U αποτελεί το διεθνές πρότυπο για λίστες καναλιών IPTV. Το Mayk IP TV υποστηρίζει παραδοσιακά αρχεία M3U καθώς και σύγχρονα αρχεία M3U8 με πλούσια μεταδεδομένα.

Δομή και σύνταξη της λίστας

Ένα έγκυρο αρχείο M3U ξεκινά πάντα με τη δήλωση #EXTM3U, ακολουθούμενη από διαδοχικά ζεύγη γραμμών μεταδεδομένων #EXTINF και άμεσων συνδέσμων ροής.

Ταξινόμηση VOD και τηλεοπτικών σειρών

Το περιεχόμενο κατηγοριοποιείται αυτόματα σε ζωντανή τηλεόραση, ταινίες ή επεισόδια σειρών βάσει μοτίβων όπως το S01 E02.

Βέλτιστες πρακτικές ανάλυσης

Χρησιμοποιείτε πάντα καθαρή κωδικοποίηση UTF-8, έγκυρους συνδέσμους HTTP/HTTPS και μοναδικά αναγνωριστικά tvg-id για σωστό ηλεκτρονικό οδηγό προγράμματος (EPG).

Επίπεδο 1: Βασικές ετικέτες #EXTINF

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
#EXTM3UΒασικό (Επίπεδο 1) · ΑπαιτείταιDirective (Header)#EXTM3UΥποχρεωτική γραμμή επικεφαλίδας που προσδιορίζει το αρχείο ως εκτεταμένη λίστα M3U.
#EXTINFΒασικό (Επίπεδο 1) · ΑπαιτείταιDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDΟδηγία πληροφοριών κομματιού που καθορίζει τη διάρκεια και τα γνωρίσματα μεταδεδομένων.
tvg-idΒασικό (Επίπεδο 1) · ΠροαιρετικόStringtrt1.trΜοναδικό αναγνωριστικό που συνδέει το κανάλι με την εγγραφή στο αρχείο XMLTV EPG.
tvg-nameΒασικό (Επίπεδο 1) · ΠροαιρετικόStringTRT 1 HDΕπίσημη ονομασία του σταθμού όπως αναγράφεται στον ηλεκτρονικό οδηγό προγράμματος.
tvg-logoΒασικό (Επίπεδο 1) · ΠροαιρετικόURL (http/https)https://stream.example.com:8080/images/trt1.pngΑπευθείας διεύθυνση URL της εικόνας λογοτύπου (κατά προτίμηση PNG ή SVG μέσω HTTPS).
group-titleΒασικό (Επίπεδο 1) · ΠροαιρετικόStringNationalΌνομα κατηγορίας κάτω από την οποία ταξινομείται το κανάλι στο μενού της εφαρμογής.
#EXTGRP:Βασικό (Επίπεδο 1) · ΠροαιρετικόDirective#EXTGRP:NationalΕναλλακτική οδηγία ομάδας τοποθετημένη αμέσως μετά τη γραμμή EXTINF.

Επίπεδο 2: Εκτεταμένες ετικέτες Mayk IP TV

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
media-typeΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόEnum ("live" | "movie" | "series")media-type="series"Ρητή παράκαμψη τύπου πολυμέσων: 'live', 'movie' ή 'series'.
series-idΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόString / Integerseries-id="show-42"Μοναδικό αναγνωριστικό σειράς που ομαδοποιεί τις ροές επεισοδίων.
series-nameΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόStringseries-name="Example Series"Κανονικός τίτλος τηλεοπτικής σειράς για συνάθροιση κύκλων και επεισοδίων.
seasonΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόIntegerseason="1"Αριθμός κύκλου για επεισόδια τηλεοπτικών σειρών (ακέραιος).
episodeΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόIntegerepisode="4"Αριθμός επεισοδίου εντός του συγκεκριμένου κύκλου (ακέραιος).
is_adultΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόInteger ("0" | "1")is_adult="1"Σημαία γονικού κλειδώματος: '1' σηματοδοτεί περιεχόμενο για ενήλικες.
age_ratingΕκτεταμένο (Επίπεδο 2) · ΠροαιρετικόStringage_rating="18+"Ελάχιστη ηλικιακή διαβάθμιση (π.χ. '18+') για φίλτρα γονικού ελέγχου.

Κανόνες ταξινόμησης περιεχομένου

Τύπος#Παράδειγμα τιμής
Ζωντανή TV#3http(s)://... | media-type="live"
Ταινία (VOD)#2/movie/... | media-type="movie"
Επεισόδιο σειράς#1/series/... + S01E01 / S01.E01 | media-type="series"

Δείγματα προτύπων

Ζωντανή TV (M3U / #EXTINF)
#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
Ταινία (VOD) & Επεισόδιο σειράς (M3U / #EXTINF)
#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

Διαδραστικός έλεγχος μορφής

Επικολλήστε το απόσπασμα M3U ή την απόκριση JSON του Xtream παρακάτω για έλεγχο συμβατότητας με το Mayk IP TV.

Λίστα ελέγχου συμβατότητας M3U

  • Βεβαιωθείτε ότι η πρώτη γραμμή του αρχείου περιέχει ακριβώς το #EXTM3U.
  • Ορίστε τη διάρκεια σε -1 για όλα τα συνεχή ζωντανά τηλεοπτικά κανάλια.
  • Αντιστοιχίστε έγκυρες τιμές tvg-id σύμφωνα με την πηγή δεδομένων XMLTV.
  • Ομαδοποιήστε λογικά τα κανάλια χρησιμοποιώντας το γνώρισμα group-title.
  • Αποθηκεύστε το αρχείο σε κωδικοποίηση UTF-8 χωρίς δείκτη σειράς byte (BOM).