Mayk IP TV

תיעוד טכני

מפרט פורמט רשימת השמעה M3U

מפרט מלא של פורמט רשימת השמעה M3U עבור IPTV. למד את תגיות רמות 1 ו-2, פענוח ערוצים ובדוק רשימות השמעה.

מבוא לפורמט M3U ב-Mayk IP TV

פורמט רשימת ההשמעה M3U מהווה את התקן הבינלאומי לרשימות ערוצי IPTV. אפליקציית Mayk IP TV תומכת הן בקובצי M3U מסורתיים והן בקובצי M3U8 מודרניים עם מטא-נתונים עשירים.

מבנה ותחביר של רשימת ההשמעה

קובץ M3U תקני נפתח תמיד בהצהרת #EXTM3U, ולאחריה זוגות רציפים של שורות מטא-נתונים #EXTINF וקישורי הזרמה ישירים.

סיווג סרטים וסדרות טלוויזיה

תכני המדיה מסווגים באופן אוטומטי לשידור חי, סרטי קולנוע או פרקי סדרות על בסיס דפוסי עונות ופרקים כגון 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כתובת אינטרנט ישירה לתמונת סמליל הערוץ (מומלץ בפורמט 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+') עבור מסנני בקרת הורים.

כללי סיווג תוכן

סוג#ערך לדוגמה
טלוויזיה חיה#3http(s)://... | media-type="live"
סרט (VOD)#2/movie/... | media-type="movie"
פרק בסדרה#1/series/... + S01E01 / S01.E01 | media-type="series"

תבניות לדוגמה

טלוויזיה חיה (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 מלא ללא סימון סדר בתים (BOM).