Mayk IP TV

기술 참조 문서

M3U 재생목록 형식 사양

IPTV용 M3U 재생목록 형식의 전체 기술 사양입니다. 계층 1 및 계층 2 태그, 채널 파싱 규칙을 학습하고 재생목록 호환성을 대화형으로 직접 검증하세요.

Mayk IP TV의 M3U 포맷 소개

M3U 재생목록 형식은 IPTV 채널 목록 구성을 위한 글로벌 표준입니다. Mayk IP TV는 기존 M3U 파일과 풍부한 메타데이터를 갖춘 최신 M3U8 파일을 모두 지원합니다.

재생목록 구조 및 구문 규격

유효한 M3U 파일은 항상 #EXTM3U 선언 줄로 시작하며, 그 뒤에 #EXTINF 메타데이터 줄과 직접 스트림 URL이 쌍을 이루어 연속 배치됩니다.

VOD 및 TV 시리즈 분류 규칙

콘텐츠는 S01 E02와 같은 시즌 및 에피소드 표기 패턴을 기반으로 실시간 방송, 영화, 시리즈 에피소드로 자동 분류됩니다.

안정적인 파싱을 위한 권장 사항

안정적인 전자 프로그램 안내(EPG) 연동을 위해 항상 순수 UTF-8 인코딩, 작동하는 HTTP/HTTPS 링크, 고유한 tvg-id 값을 설정하세요.

계층 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전자 프로그램 안내(EPG)에 공식 등록된 채널 명칭.
tvg-logo표준 (계층 1) · 선택URL (http/https)https://stream.example.com:8080/images/trt1.png채널 로고 이미지로 연결되는 직접 웹 링크(HTTPS 기반 PNG 또는 SVG 권장).
group-title표준 (계층 1) · 선택StringNational플레이어 인터페이스 메뉴에서 채널이 분류되어 표시될 카테고리 이름.
#EXTGRP:표준 (계층 1) · 선택Directive#EXTGRP:NationalEXTINF 줄 바로 뒤에 배치되는 대체 그룹 분류 지시문.

계층 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"시즌과 회차 트랙을 통합하기 위한 공식 TV 시리즈 명칭.
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

대화형 포맷 검사기

Mayk IP TV와의 호환성을 확인하려면 아래에 M3U 코드 또는 Xtream JSON 응답을 붙여넣으세요.

M3U 호환성 점검 목록

  • 파일의 가장 첫 줄이 정확히 #EXTM3U로 시작하는지 확인하세요.
  • 모든 연속 실시간 TV 채널의 재생 시간을 -1로 지정하세요.
  • XMLTV 소스 데이터와 완벽히 일치하는 정확한 tvg-id 값을 부여하세요.
  • group-title 속성을 활용하여 채널을 깔끔한 그룹으로 분류하세요.
  • BOM(바이트 순서 표식)이 없는 순수 UTF-8 인코딩으로 파일을 저장하세요.