M3U vs Xtream Codes: que ligação IPTV usar
Compare as listas de reprodução M3U e a API Xtream Codes, veja como cada uma carrega canais e dados de EPG e escolha a melhor opção.
Atualizado a 14 de novembro de 2026 4 min de leitura
Nesta página
Quando configura um leitor de IPTV como o TiviMate, o IPTV Smarters Pro ou uma aplicação para Apple TV, normalmente escolhe entre dois métodos de ligação: um URL de lista de reprodução M3U ou a API Xtream Codes.
Ambos os métodos disponibilizam TV em direto, filmes e guias eletrónicos de programação (EPG) no seu dispositivo, mas processam e estruturam os dados de forma diferente. A escolha afeta a estabilidade do streaming, a organização dos canais, os tempos de carregamento do EPG e as funcionalidades de vídeo a pedido (VOD).
Como funcionam as listas de reprodução M3U
Um M3U (MP3 URL) é um ficheiro de texto simples, ou um único URL web longo, que contém uma lista sequencial de endereços de streaming e metadados básicos dos canais.
Quando cola uma ligação M3U numa aplicação de IPTV, a aplicação transfere todo o ficheiro de texto de uma só vez. O ficheiro contém etiquetas de multimédia como:
http://server.address/get.php?username=ABCD&password=EFGH&type=m3u_plus&output=t
- Estrutura de dados: o ficheiro M3U associa o nome do canal, a categoria (
group-title), o logótipo do canal e a ligação direta ao servidor (stream.tsou.m3u8). - Integração do EPG: as listas de reprodução M3U simples não incluem dados do guia de TV. Para obter a programação dos canais, tem de encontrar e colar um URL de EPG XMLTV separadamente.
- Atualizações: o ficheiro é estático após a transferência. Qualquer alteração que o seu fornecedor faça aos números dos canais ou aos endereços de streaming exige uma atualização manual completa da lista de reprodução na sua aplicação.
Como funciona a API Xtream Codes
A API Xtream Codes é um protocolo de base de dados. Cria uma ligação direta e interativa entre a sua aplicação de leitor de IPTV e o servidor de gestão do fornecedor.
Em vez de colar uma longa ligação de texto, introduza três parâmetros:
- URL do servidor (Server URL), por exemplo
http://line.provider.com - Nome de utilizador (Username)
- Palavra-passe (Password)
Quando clica em iniciar sessão, o seu leitor de IPTV envia pedidos separados e leves à base de dados do servidor:
- Canais em direto:
/player_api.php?username=...&password=...&action=get_live_streams - Guia EPG:
/player_api.php?username=...&password=...&action=get_short_epg - VOD e séries:
/player_api.php?username=...&password=...&action=get_vod_streams
Como os pedidos são divididos em chamadas separadas à base de dados, a aplicação carrega as listas de canais, os guias EPG e os cartazes dos filmes de VOD de forma independente, em segundo plano, sem bloquear a interface.
Principais diferenças
| Funcionalidade | Lista de reprodução M3U | API Xtream Codes |
|---|---|---|
| Início de sessão | Um único URL longo | URL do servidor, nome de utilizador e palavra-passe |
| Dados | Uma lista de canais em texto simples | Consultas separadas à base de dados |
| EPG | É necessário um URL XMLTV separado | Carregado através da API |
| Atualizações | É necessário atualizar manualmente a lista de reprodução | Os dados atuais são consultados a pedido |
| Ideal para | Leitores básicos, listas personalizadas e algumas boxes Enigma2 | A maioria dos leitores modernos |
Qual deve utilizar
Utilize a API Xtream Codes
Escolha sempre a API Xtream Codes quando o seu fornecedor a suporta e o seu leitor a permite. Proporciona uma melhor experiência de utilizador, dados precisos do guia de TV, cartazes de filmes e séries organizados e suporte nativo de gravações automáticas.
Se o seu fornecedor enviou apenas uma única ligação web M3U longa, não tem de escrever a ligação completa no televisor. Pode extrair os seus dados de início de sessão seguindo como encontrar o endereço do servidor num URL M3U.
Utilize uma lista de reprodução M3U apenas quando
- A sua aplicação de leitor suporta apenas ligações de listas de reprodução, como leitores web básicos ou aplicações mais antigas para televisores inteligentes.
- Carrega listas de canais personalizadas e editadas de forma privada ou ficheiros
.m3upersonalizados criados com editores de listas de reprodução. - Utiliza hardware especializado, como certas box Enigma2, que preferem importações diretas de cadeias M3U.
Resolver problemas de ligação
- A aplicação fecha ao iniciar com uma lista de reprodução M3U. Se o seu fornecedor oferece uma biblioteca muito grande (mais de 100 000 streams em direto e filmes), carregar um ficheiro M3U em bruto pode esgotar a memória de dispositivos de streaming com pouca RAM, como o Fire TV Stick. Mude para a API Xtream Codes para consultar as categorias a pedido.
- Os streams congelam ou ficam em memória intermédia. Com qualquer dos métodos, a estabilidade do streaming depende do encaminhamento da rede. Se a memória intermédia continuar, consulte memória intermédia no IPTV para ajustar os tamanhos da memória intermédia ou corrigir a limitação do ISP.
Mais em Noções básicas de IPTV
Ainda com dificuldades?
A nossa equipa de suporte pode ajudar a configurar o seu dispositivo ou a resolver um problema.