#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
Especificacións técnicas e estándares
Especificación de lista M3U e etiquetas #EXTINF
Descubra como Mayk IP TV analiza listas M3U e M3U Plus, asigna metadatos e clasifica emisións en directo, filmes e series.
Cabeceira de ficheiro e codificación
Un ficheiro de lista M3U debe comezar pola directiva #EXTM3U na primeira liña. Os ficheiros deben codificarse en UTF-8 con saltos de liña LF ou CRLF. Todos os URL deben ser absolutos en HTTP ou HTTPS.
Nivel 1 Etiquetas #EXTINF estándar
Os metadatos defínense na liña #EXTINF mediante pares clave-valor entre comiñas dobres. tvg-id asocia a guía EPG, tvg-name o nome alternativo, tvg-logo o logotipo e group-title a categoría.
Clasificación automática de medios
Mayk IP TV clasifica os URL con /movie/ como filmes (VOD) e os URL con /series/ e patróns como S01E01 ou S01.E01 como episodios de series. O resto trátase como televisión en directo.
Nivel 2 Etiquetas estendidas
Os xeradores de listas poden incluír media-type="live|movie|series", series-name, season e episode para determinar o tipo de contido directamente sen depender das rutas.
Tamaño do catálogo e rendemento
As listas planas sen comprimir de máis de 40 MB saturan a memoria dos televisores intelixentes. Recoméndase activar compresión HTTP gzip ou usar a API de Xtream Codes.
Nivel 1: Etiquetas #EXTINF estándar
| Campo / Etiqueta | Nivel | Tipo | Valor de exemplo | Descrición |
|---|---|---|---|---|
#EXTM3U | Estándar (Nivel 1) · Obrigatorio | Directive (Header) | #EXTM3U | Cabeceira da lista; debe ser a primeira liña de calquera ficheiro M3U válido. |
#EXTINF | Estándar (Nivel 1) · Obrigatorio | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Directiva principal que indica a duración da emisión e os seus atributos de metadatos. |
tvg-id | Estándar (Nivel 1) · Opcional | String | trt1.tr | Identificador de canle para sincronización coa guía electrónica de programas (EPG). |
tvg-name | Estándar (Nivel 1) · Opcional | String | TRT 1 HD | Nome de canle alternativo empregado como apoio para a busca na guía. |
tvg-logo | Estándar (Nivel 1) · Opcional | URL (http/https) | https://stream.example.com:8080/images/trt1.png | URL directo en HTTP ou HTTPS cara ao logotipo da canle ou imaxe de portada. |
group-title | Estándar (Nivel 1) · Opcional | String | National | Nome de categoría para organizar canles e contidos en grupos temáticos. |
#EXTGRP: | Estándar (Nivel 1) · Opcional | Directive | #EXTGRP:National | Directiva de grupo alternativa situada inmediatamente despois da liña EXTINF. |
Nivel 2: Etiquetas estendidas de Mayk IP TV
| Campo / Etiqueta | Nivel | Tipo | Valor de exemplo | Descrición |
|---|---|---|---|---|
media-type | Extendido (Nivel 2) · Opcional | Enum ("live" | "movie" | "series") | media-type="series" | Especificación explícita do tipo de medio: 'live', 'movie' ou 'series'. |
series-id | Extendido (Nivel 2) · Opcional | String / Integer | series-id="show-42" | Identificador único para agrupar múltiples episodios baixo unha mesma serie. |
series-name | Extendido (Nivel 2) · Opcional | String | series-name="Example Series" | Título canónico da serie de televisión para asociar tempadas. |
season | Extendido (Nivel 2) · Opcional | Integer | season="1" | Número de tempada do episodio da serie (número enteiro). |
episode | Extendido (Nivel 2) · Opcional | Integer | episode="4" | Número de episodio dentro da tempada correspondente (número enteiro). |
is_adult | Extendido (Nivel 2) · Opcional | Integer ("0" | "1") | is_adult="1" | Indicador de control parental: '1' marca contido restrinxido para adultos. |
age_rating | Extendido (Nivel 2) · Opcional | String | age_rating="18+" | Etiqueta de idade mínima recomendada (por exemplo, '18+') para filtros parentais. |
Regras de clasificación
| Tipo | # | Valor de exemplo |
|---|---|---|
| TV en directo | #3 | http(s)://... | media-type="live" |
| Filme (VOD) | #2 | /movie/... | media-type="movie" |
| Episodio de serie | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Modelos de exemplo
#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
Comprobador de formato interactivo
Pegue o seu fragmento M3U ou resposta JSON Xtream a continuación para verificar a compatibilidade con Mayk IP TV.
Lista de control de compatibilidade M3U
- Asegúrese de que a primeira liña sexa #EXTM3U e a codificación sexa UTF-8.
- Poña sempre todos os valores dos atributos entre comiñas dobres.
- Estruture filmes con /movie/ e series con /series/ e o patrón SxxEyy.
- Empregue enderezos HTTP/HTTPS válidos e directos para os logotipos.
- Evite liñas separadoras decorativas e use o atributo group-title.