Xtream Codes API vs Lista M3U: qual usar?
Use Xtream Codes se o operador enviou utilizador, palavra-passe e URL do servidor em separado. Use Lista M3U se recebeu um único URL com ".m3u" ou "m3u_plus".
O IPTV Smarters Pro suporta dois métodos de ligação. Qual o seu caso depende do que o operador fornece. A ativação é feita na própria app após escolher o método.
| Critério | Xtream Codes API | Lista M3U |
|---|---|---|
| O operador fornece | URL do servidor + utilizador + palavra-passe | Um URL de ficheiro .m3u ou .m3u8 |
| Atualização automática da lista | Sim (a app pede ao servidor) | Apenas se o URL for dinâmico |
| Suporte a EPG integrado | Sim (via Xtream Codes) | Depende do operador |
| Catch-up / gravação | Sim (se o servidor suportar) | Limitado |
| Séries e VOD organizados | Sim (secções separadas) | Numa lista única |
| Compatível com todos os dispositivos | Sim | Sim |
Regra prática: se o operador enviar um nome de utilizador, palavra-passe e URL de servidor em separado, use Xtream Codes. Se enviar um único URL com ".m3u" ou "m3u_plus", use Lista M3U.
Configurar com Xtream Codes API — passo a passo
O que precisa: URL do servidor (ex: http://servidor.exemplo.com:8080), nome de utilizador e palavra-passe fornecidos pelo operador.
Passo 1 — Abrir o IPTV Smarters Pro No ecrã de boas-vindas, prima "Adicionar utilizador" (ou o ícone "+" se já tiver perfis).
Passo 2 — Selecionar o método Escolha "Xtream Codes API".
Passo 3 — Preencher os campos
- Nome de utilizador (Username): copie diretamente do e-mail ou mensagem do operador. Não adicione espaços.
- Palavra-passe (Password): idem. Atenção a caracteres especiais como @, # ou / que podem ser mal copiados.
- URL do servidor: introduza o URL completo com porta. Formato habitual: http://servidor.com:porta. Não adicione / no fim.
Passo 4 — Confirmar e aguardar Prima "Adicionar utilizador". A app liga ao servidor, valida as credenciais e carrega a lista. Se aparecer erro, consulte a secção de erros de digitação abaixo.
Passo 5 — Verificar o carregamento Após autenticação bem-sucedida, o IPTV Smarters Pro apresenta os grupos de canais. Se a lista ficar vazia, o problema está no servidor do operador ou nas credenciais — não na app.
Configurar com Lista M3U — passo a passo
O que precisa: um URL de lista M3U fornecido pelo operador (começa habitualmente com http:// ou https:// e termina em .m3u, .m3u8 ou inclui o parâmetro type=m3u_plus).
Passo 1 — Abrir o IPTV Smarters Pro Prima "Adicionar utilizador".
Passo 2 — Selecionar o método Escolha "Lista M3U / URL externo" (a designação pode variar ligeiramente conforme a versão).
Passo 3 — Introduzir o URL
Cole o URL completo no campo indicado. Se o URL incluir parâmetros (ex: ?username=x&password=y), copie-o na íntegra, sem quebras de linha.
Passo 4 — Nomear o perfil Dê um nome ao perfil (ex: "Casa") para facilitar a gestão se tiver várias listas.
Passo 5 — Aguardar o carregamento A app descarrega o ficheiro M3U e cria os grupos de canais. Listas grandes (mais de 10 000 entradas) podem demorar 1 a 3 minutos na primeira vez.
Sobre listas M3U e EPG: se o operador não incluir o URL de EPG no próprio ficheiro M3U, terá de o introduzir manualmente em Definições. Consulte o guia completo de EPG.
Erros de digitação mais frequentes na configuração
Estes erros são responsáveis pela maioria das falhas de autenticação:
1. Espaço no início ou no fim do campo
Ao copiar as credenciais de um e-mail ou mensagem, é comum incluir um espaço invisível antes ou depois do texto. Solução: apague o campo completamente e volte a escrever manualmente, ou use a opção "colar" com atenção.
2. URL sem porta ou com porta errada
O formato correto é http://servidor.com:8080. Esquecer :8080 (ou o número de porta específico do operador) impede a ligação. Verifique o e-mail do operador com atenção.
3. HTTPS em vez de HTTP (ou vice-versa)
Alguns servidores usam HTTP, outros HTTPS. Se o operador indicar http://, não mude para https:// por iniciativa própria.
4. Barra "/" no fim do URL do servidor
O campo URL do servidor não deve terminar com /. http://servidor.com:8080/ causa erro em alguns servidores.
5. Letra maiúscula onde há minúscula
Os nomes de utilizador e palavras-passe são sensíveis a maiúsculas/minúsculas. Usuario e usuario são credenciais diferentes.
6. Caracteres especiais mal copiados
Símbolos como @, &, # podem ser alterados em alguns clientes de e-mail ou aplicações de mensagens. Se a palavra-passe os contiver, confirme o valor original com o operador.
Se corrigiu todos estes pontos e o erro persiste, o problema pode ser a conta expirada ou o servidor do operador indisponível. Consulte o guia de falha de login.
Como identificar e verificar o URL do servidor
O URL do servidor Xtream Codes tem sempre esta estrutura:
http://servidor.exemplo.com:PORTA
Onde PORTA é um número entre 1 e 65535 (habitualmente 80, 8080, 25461 ou outros). O operador comunica esta informação quando envia as credenciais.
Como testar o URL manualmente:
Abra um browser no telemóvel ou computador e introduza:
http://servidor.com:porta/get.php?username=SEU_USER&password=SUA_PASS&type=m3u_plus
Se o servidor responder com um ficheiro M3U ou com texto de canais, o URL e as credenciais estão corretos. Se aparecer erro de ligação ou página em branco, o servidor está indisponível ou os dados estão errados.
URL do servidor vs URL de stream: Não confunda o URL base do servidor (que introduz na app) com o URL de um canal individual (stream). São coisas distintas — a app usa o URL base para se autenticar e gerar os URLs de stream automaticamente.
Leitores de stream compatíveis: o IPTV Smarters Pro inclui o ExoPlayer (leitor interno) e suporta o VLC. Se o stream funciona no VLC mas não no ExoPlayer (ou vice-versa), o problema é do codec, não do servidor.
Fonte técnica de referência: documentação do protocolo Xtream Codes e suporte oficial do editor (iptvsmarters.com).
Precisa de mais ajuda com a configuração inicial? O guia Como descarregar IPTV Smarters Pro explica também como verificar que instalou a versão correta antes de configurar.
Última atualização: — equipa editorial Smarters Pros.
Posso ter Xtream Codes e M3U no mesmo perfil?
Não. Cada perfil usa um método. Pode, no entanto, criar vários perfis na app — um com Xtream Codes e outro com M3U — e alternar entre eles.
O que fazer se o servidor rejeitar as credenciais mas o operador garante que estão corretas?
Teste o URL manualmente no browser (ver secção acima). Se funcionar no browser mas não na app, tente reinstalar o IPTV Smarters Pro. Se não funcionar no browser, o problema é do servidor do operador.
A app pede EPG URL — o que introduzir?
O EPG URL é fornecido pelo operador ou está incluído automaticamente em contas Xtream Codes. Se não o tiver, deixe em branco ou consulte o guia de EPG.
Consigo usar uma lista M3U de um ficheiro local (guardado no telemóvel)?
Em algumas versões da app, é possível carregar um ficheiro M3U local. No entanto, esta opção não está disponível em todas as plataformas. A ligação via URL é mais fiável.
Quanto tempo demora a carregar uma lista grande?
Listas com mais de 10 000 canais podem demorar 2 a 5 minutos na primeira sincronização, dependendo da velocidade de ligação e do aparelho.
A configuração fica guardada se reinstalar a app?
Não. As configurações são guardadas localmente. Ao reinstalar, terá de adicionar o perfil novamente.