IPTV do zero: lance seu serviço com Catena e iMPlayer

Um serviço IPTV ganha valor para o cliente quando ele consegue abrir seus canais na TV, encontrar um programa e assistir. Com o Catena, você gerencia a transmissão e os pacotes de canais em um único console. O iMPlayer oferece a interface do espectador, recebendo do Catena a lista pessoal de canais e a programação.

Nosso guia original de IPTV do zero aborda toda a infraestrutura, incluindo recepção via satélite e servidores separados de transcodificação e distribuição. Aqui seguimos um lançamento concreto com Catena e iMPlayer: alguns canais, um pacote de teste e um assinante de teste. Quando esse caminho funcionar, você terá uma base para adicionar canais e conectar seus sistemas comerciais.

O papel de cada componente

O iMPlayer é um player de mídia; os canais são fornecidos por você. Você precisa de conteúdo com direito de distribuição, um dispositivo compatível com iMPlayer, um servidor Catena e um domínio acessível pela rede do assinante. Uma máquina Catena pode hospedar o primeiro piloto; hardware e conexão dependem das fontes, da transcodificação e dos espectadores simultâneos.

Etapa 1. Instalar o Catena e verificar o primeiro stream

Siga o início rápido do Catena em Ubuntu 24.04. Ele explica a instalação, o acesso do administrador e uma fonte sintética com preset de transcodificação H.264/AAC. Assim você verifica o caminho do vídeo antes de depender de um fornecedor real.

Depois, crie um stream em Streams e conecte a fonte que será transmitida. Confira imagem e áudio no console. Adicione transcodificação se precisar de outros codecs ou de uma escada de qualidades para conexões diferentes. A prévia funcionando é o primeiro ponto de controle: uma playlist não corrige um sinal de entrada com defeito.

Use seu domínio público e configure HTTPS. Tanto o serviço quanto os endereços de reprodução para os quais ele redireciona precisam ser acessíveis pela rede do assinante. Teste também fora da rede local do operador.

Etapa 2. Transformar transmissões em uma grade de canais

O stream descreve a transmissão técnica: fontes, transcodificação e gravação. O canal descreve o que o cliente vê: título, número e vínculo com esse stream.

Em Canais, crie um canal, atribua o stream e o número. Dê um título claro e, quando útil, um grupo como Notícias, Esportes ou Filmes. Adicione um logotipo ou aplique a sugestão da fonte EPG. O Catena exporta grupos e logotipos na playlist IPTV compatível, facilitando a navegação.

Repita para os canais do piloto. Confira a atribuição de cada stream: um canal sem stream fica fora da playlist exportada. O manual de canais explica essa relação.

Etapa 3. Criar um pacote e um assinante de teste

Em Pacotes, crie um pacote como basic e adicione os canais do piloto. Defina o limite de telas simultâneas para a oferta que pretende testar. Um pacote gratuito fica disponível para todos os assinantes: ative Gratuito apenas para os canais destinados a todos.

Em Assinantes, crie um cliente de teste e assine o pacote basic para ele. Confira Canais disponíveis na ficha: esse conjunto será usado na exportação. O cliente recebe os canais de seus pacotes e dos gratuitos; um canal que não pertence a nenhum pacote não fica disponível para ninguém.

Copie o Token de reprodução para a próxima etapa. Cada cliente deve receber seus próprios links. Você pode configurar as fichas manualmente no piloto e conectar a atribuição de pacotes ao faturamento pela API do Catena conforme crescer.

Etapa 4. Preparar a programação

Em Guia de programação, adicione a URL da fonte XMLTV e o intervalo de atualização. Vincule cada stream ao canal correspondente nessa fonte. O Catena pode sugerir correspondências por nome: revise antes de aplicar uma atribuição em lote.

Confira se os programas aparecem no Catena antes de testar a programação no iMPlayer. Um arquivo baixado com sucesso sem streams vinculados produz uma grade vazia. O Catena exporta a programação dos canais disponíveis ao assinante, usando os mesmos identificadores para associar M3U e XMLTV. O manual de EPG explica importação e diagnóstico.

Etapa 5. Entregar dois links do assinante ao iMPlayer

Use o domínio do Catena e o token da ficha do assinante. Para uma instalação em tv.example.com, os endereços são:

Playlist M3U:
https://tv.example.com/playback/tv/iptv.m3u8?token=SUBSCRIBER_TOKEN

Programação XMLTV:
https://tv.example.com/playback/tv/xmltv.xml?token=SUBSCRIBER_TOKEN

Substitua o domínio e SUBSCRIBER_TOKEN pelos seus valores. Abra a URL da playlist no navegador: a resposta deve começar com #EXTM3U e conter seus canais.

Use iptv.m3u8 neste cenário. O Catena também oferece playlist.m3u8, mas a exportação IPTV fornece os endereços HLS absolutos esperados pelos players compatíveis com o formato Flussonic. No Catena 26.10, esses links levam as credenciais do assinante: a lista importada não deixa de funcionar apenas porque um ticket de reprodução de curta duração expirou. Baixe novamente a lista quando seus canais mudarem.

No iMPlayer, adicione uma playlist pela opção M3U URL, dê um nome e cole o primeiro endereço. Informe o segundo como EPG/XMLTV URL dessa playlist, salve e atualize os canais e a programação. Os nomes dos menus variam conforme a versão; aqui usamos M3U e XMLTV em vez de credenciais de portal. Baixe o aplicativo pelo site oficial do iMPlayer e consulte a ajuda para seu dispositivo.

Abra um canal, mude para outro e confira o programa atual. Compartilhe os links de forma privada: eles contêm as credenciais do cliente. O manual de playlists e XMLTV lista os endereços de exportação.

Etapa 6. Adicionar catch-up e verificar o acesso

Ative a gravação DVR nos streams que quer arquivar e espere acumular gravações. Quando existe um arquivo, o Catena adiciona catchup="fs" e catchup-days à entrada IPTV. Teste o catch-up compatível com Flussonic no dispositivo e na versão que pretende oferecer. EPG fornece a programação; assistir a programas passados exige uma gravação real dentro da janela do arquivo.

Antes de convidar clientes, verifique a autorização de reprodução. Os pacotes são uma parte do controle de acesso; a distribuição do vídeo também precisa de proteção. Teste o cliente autorizado, uma solicitação sem acesso, um canal fora do pacote e o excesso de telas simultâneas. Se o conteúdo exigir DRM, valide separadamente toda a combinação de DRM e dispositivo.

Etapa 7. Ensaiar a ativação e o suporte

O piloto deve cobrir toda a jornada: atribuir um pacote, enviar dois links, reproduzir, atualizar a programação e mudar a grade. Teste pela rede do cliente, incluindo reinício do dispositivo e nova reprodução no dia seguinte.

Em Sessões do Catena, confira se o assinante chegou à reprodução. Isso ajuda a distinguir um problema de configuração do player de um problema na fonte ou na distribuição.

Conforme o serviço cresce, adicione streamers e separe distribuição e arquivo de acordo com a carga. Para uma biblioteca de filmes, veja como o catálogo VOD do Catena ajuda seu cinema online. O piloto oferece um caminho de transmissão e acesso do assinante já verificado.

Planejar um piloto IPTV com Catena