Mayk IP TV

Especificações técnicas e normas

Especificação de lista de reprodução M3U e #EXTINF

Saiba como o Mayk IP TV analisa listas M3U e M3U Plus em Portugal, mapeia metadados e classifica canais em direto, filmes e séries.

Cabeçalho do ficheiro e codificação

O ficheiro de lista de reprodução M3U deve principiar com #EXTM3U na primeira linha. Os ficheiros devem ser codificados em UTF-8 com terminações LF ou CRLF. Todos os URL devem ser absolutos em HTTP ou HTTPS.

Nível 1 Etiquetas #EXTINF padrão

Os metadados são configurados na linha #EXTINF através de atributos entre aspas duplas. tvg-id associa o guia EPG, tvg-name o nome de recurso, tvg-logo o logótipo e group-title a categoria.

Classificação automática de conteúdos

O Mayk IP TV classifica os URL com /movie/ como filmes (VOD) e os URL com /series/ e padrões como S01E01 ou S01.E01 como episódios de séries. As restantes emissões são tidas como TV em direto.

Nível 2 Etiquetas expandidas

Os criadores de listas podem fornecer media-type="live|movie|series", series-name, season e episode para indicar expressamente o género de conteúdo sem estar dependente de caminhos.

Dimensão do catálogo e desempenho

Listas extensas não comprimidas com mais de 40 MB sobrecarregam a memória da Smart TV. Recomenda-se ativar compressão HTTP gzip ou disponibilizar a API Xtream Codes.

Nível 1: Etiquetas #EXTINF padrão

Campo / EtiquetaNívelTipoValor de exemploDescrição
#EXTM3UPadrão (Nível 1) · ObrigatórioDirective (Header)#EXTM3UCabeçalho da lista de reprodução; tem de ser a primeiríssima linha de todo o ficheiro M3U válido.
#EXTINFPadrão (Nível 1) · ObrigatórioDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDiretiva principal que indica a duração do fluxo e os respetivos atributos de metadados.
tvg-idPadrão (Nível 1) · OpcionalStringtrt1.trIdentificador de canal para correspondência com o guia eletrónico de programação (EPG).
tvg-namePadrão (Nível 1) · OpcionalStringTRT 1 HDNome de canal alternativo usado para localização no guia de programação.
tvg-logoPadrão (Nível 1) · OpcionalURL (http/https)https://stream.example.com:8080/images/trt1.pngURL direto em HTTP ou HTTPS para a imagem do logótipo ou cartaz do conteúdo.
group-titlePadrão (Nível 1) · OpcionalStringNationalNome de categoria para agrupar os canais e conteúdos por temáticas.
#EXTGRP:Padrão (Nível 1) · OpcionalDirective#EXTGRP:NationalDiretiva de grupo alternativa posicionada imediatamente após a linha EXTINF.

Nível 2: Etiquetas expandidas Mayk IP TV

Campo / EtiquetaNívelTipoValor de exemploDescrição
media-typeExpandido (Nível 2) · OpcionalEnum ("live" | "movie" | "series")media-type="series"Substituição expressa do tipo de multimédia: 'live', 'movie' ou 'series'.
series-idExpandido (Nível 2) · OpcionalString / Integerseries-id="show-42"Identificador único que congrega múltiplos episódios sob a mesma série.
series-nameExpandido (Nível 2) · OpcionalStringseries-name="Example Series"Título canónico da série de televisão para agregar temporadas.
seasonExpandido (Nível 2) · OpcionalIntegerseason="1"Número da temporada do episódio da série (número inteiro).
episodeExpandido (Nível 2) · OpcionalIntegerepisode="4"Número de ordem do episódio na respetiva temporada (número inteiro).
is_adultExpandido (Nível 2) · OpcionalInteger ("0" | "1")is_adult="1"Indicador de controlo parental: '1' assinala conteúdo reservado a adultos.
age_ratingExpandido (Nível 2) · OpcionalStringage_rating="18+"Classificação etária mínima recomendada (ex.: '18+') para os filtros de proteção.

Regras de classificação

Tipo#Valor de exemplo
TV em direto#3http(s)://... | media-type="live"
Filme (VOD)#2/movie/... | media-type="movie"
Episódio de série#1/series/... + S01E01 / S01.E01 | media-type="series"

Modelos de exemplo

TV em direto (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
Filme (VOD) & Episódio de série (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

Verificador de formato interativo

Cole o seu excerto M3U ou resposta JSON Xtream abaixo para verificar a conformidade com o Mayk IP TV.

Lista de verificação de compatibilidade M3U

  • Assegure-se de que a primeira linha é #EXTM3U e a codificação é UTF-8.
  • Coloque sempre todos os valores dos atributos entre aspas duplas.
  • Estruture filmes com /movie/ e séries com /series/ e a marcação SxxEyy.
  • Indique endereços HTTP/HTTPS válidos e diretos para todos os logótipos.
  • Evite separadores decorativos na lista e adote o atributo group-title.