Saltar para o conteúdo

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 .ts ou .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:

  1. URL do servidor (Server URL), por exemplo http://line.provider.com
  2. Nome de utilizador (Username)
  3. 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

FuncionalidadeLista de reprodução M3UAPI Xtream Codes
Início de sessãoUm único URL longoURL do servidor, nome de utilizador e palavra-passe
DadosUma lista de canais em texto simplesConsultas separadas à base de dados
EPGÉ necessário um URL XMLTV separadoCarregado através da API
AtualizaçõesÉ necessário atualizar manualmente a lista de reproduçãoOs dados atuais são consultados a pedido
Ideal paraLeitores básicos, listas personalizadas e algumas boxes Enigma2A 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 .m3u personalizados 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.

Contactar o suporte