Do Astra ao Alta: HLS e arquivo de TV para os seus canais
Conferido no laboratório em 15 de novembro de 2026, com o Astra 250612 e o Alta 261020.
O Astra recebe canais de TV. O Alta os entrega como HLS e guarda o arquivo. Este artigo leva um canal do Astra até um player através do Alta e depois importa os outros canais de uma vez. Cada passo mostra primeiro a interface web; a aba API traz o mesmo passo como comando.
O que foi conferido
Seção intitulada “O que foi conferido”Cada passo abaixo foi feito como está escrito, apenas com outros endereços: uma vez na interface web e outra com a API, cada vez em um serviço novo do Alta com a licença de teste compartilhada. O Astra rodava em outro servidor e reproduzia um arquivo de teste como o canal lab1. As capturas de tela são desse teste.
Não conferidos aqui: UDP entre os dois servidores, a recepção DVB, a autorização e a etapa da licença do Astra - o Astra do laboratório usou uma licença que já estava no servidor dele.
Do que você precisa
Seção intitulada “Do que você precisa”- O Astra com um canal funcionando. Veja Instalar o Astra.
- O Alta, com o login de administrador e as portas do assistente de instalação. Veja Instalando o Alta.
- O servidor do Alta precisa alcançar a porta HTTP do Astra.
Nos exemplos o Astra responde em astra.example.com:8000. A interface web e a API do Alta ficam em alta.example.com:8100 e o servidor OTT em alta.example.com:8102: são as portas que o assistente do Alta 261020 oferece por padrão.
1. Abra o acesso HTTP no Astra
Seção intitulada “1. Abra o acesso HTTP no Astra”Na interface web do Astra abra Settings → HTTP Play, ative Allow HTTP access to all streams e clique em APPLY & RESTART. O Astra reinicia e pede que você entre de novo. Leia mais em HTTP Play.

Peça a playlist ao Astra:
curl -s http://astra.example.com:8000/playlist.m3u8#EXTM3U#EXTINF:-1 group-title="-",Lab Onehttp://astra.example.com:8000/play/lab1Cada link é o endereço HTTP MPEG-TS de um canal: /play/ e o ID do canal.
O laboratório rodou dentro de uma só rede, sem autorização. No seu servidor qualquer pessoa que alcance essa porta pode abrir os canais: limite a porta com um firewall ou leia Autorização HTTP.
2. Crie um armazenamento para o arquivo
Seção intitulada “2. Crie um armazenamento para o arquivo”Na interface web do Alta abra Settings → Storages e clique em Create. Informe o nome, a duração em horas e o diretório e clique em Save.

Primeiro obtenha um token:
TOKEN=$(curl -sS -X POST 'http://alta.example.com:8100/api/login' \ -H 'Content-Type: application/json' \ -d '{"id": "admin", "password": "PASSWORD"}')Depois crie o armazenamento:
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/storage' \ -d '{"id": "archive", "duration": 24, "local": "/var/lib/alta/archive"}'O Alta responde 204 com o corpo vazio. Leia mais em Início rápido da HTTP API e API de armazenamentos.
Dê a cada armazenamento um diretório vazio próprio: quando você exclui um armazenamento ou um canal, o Alta remove o arquivo dele. No laboratório o Alta criou o diretório sozinho quando a gravação começou.
3. Adicione o canal do Astra como receptor
Seção intitulada “3. Adicione o canal do Astra como receptor”Abra Receivers e clique em Create. Ative Enable, dê um nome ao receptor e coloque o link do Astra em Source. Clique em Save.

Alguns segundos depois a lista mostra a velocidade do stream:

curl -sS -X POST -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/receiver' \ -d '{"id": "news-source", "name": "News source", "source": "http://astra.example.com:8000/play/lab1", "enable": true}'O Alta responde 204. Leia mais em API de receptores.
4. Crie o canal
Seção intitulada “4. Crie o canal”Abra Channels e clique em Create. Ative Enable, coloque news em Path e News em Name. Em Variants ative Enable para main e escolha o receptor. Abra Storage & Duration e escolha o armazenamento. Clique em Save.

curl -sS -X POST -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/channel' \ -d '{"id": "news", "name": "News", "enable": true, "storage": "archive", "variants": {"main": {"enable": true, "receiver": "news-source"}}}'O Alta responde 204. Leia mais em API de canais.
Um receptor alimenta uma variante de um canal.
5. Confira o canal
Seção intitulada “5. Confira o canal”Abra o Dashboard. Um cartão verde significa que o canal está transmitindo. O cartão mostra os espectadores e a velocidade.

curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/receiver/status'{ "receivers": { "news-source": { "totalBytes": "", "speed": "451733" } } }Um speed que não está vazio significa que o Alta recebe o stream.
O canal toca em /news/index.m3u8 no servidor OTT:
curl -sS http://alta.example.com:8102/news/index.m3u8#EXTM3U#EXT-X-STREAM-INF:BANDWIDTH=3493002,CODECS="avc1.64001f,mp4a.40.33",RESOLUTION=1280x720,FRAME-RATE=25http://alta.example.com:8102/news/main/de21b4e1.m3u8Abra o link em um player. No laboratório o ffmpeg decodificou 250 quadros de 10 segundos desse link; o canal de teste tem 25 quadros por segundo.
ffmpeg -t 10 -i http://alta.example.com:8102/news/index.m3u8 -map 0:v:0 -f null -6. Reproduza um momento anterior
Seção intitulada “6. Reproduza um momento anterior”ffmpeg -i 'http://alta.example.com:8102/news/index.m3u8?start=-60&duration=20' -map 0:v:0 -f null -start=-60 são 60 segundos antes de agora e duration=20 pede 20 segundos. No laboratório, um minuto depois de o canal começar, o ffmpeg decodificou 600 quadros: 24 segundos, porque a playlist contém segmentos inteiros. Leia mais em Formato de URL para acesso HLS.
7. Importe os outros canais de uma vez
Seção intitulada “7. Importe os outros canais de uma vez”O Alta lê uma playlist M3U e cria um receptor e um canal para cada item. A playlist do Astra é uma delas. O Alta a baixa a partir do próprio servidor.
Abra Receivers e clique em Import m3u. Coloque o link da playlist em File URL e clique em Next. Marque os canais que você quer, ou Select All, e clique em Import selected.
http://astra.example.com:8000/playlist.m3u8
O último passo mostra o que o Alta pulou. No laboratório ele pulou Lab One: esse canal já tinha um receptor com a mesma fonte.

Os receptores importados ficam desligados. Ligue cada um pela chave em Receivers. No laboratório Lab Two mostrou então 3,48 Mbit/s e o canal dele tocou em /labtwo/index.m3u8.
Leia a playlist:
curl -sS -H "Authorization: Bearer $TOKEN" \ 'http://alta.example.com:8100/api/ott/receiver/importm3u?id=http://astra.example.com:8000/playlist.m3u8'[ { "id": "", "name": "Lab One", "channel_path": "labone", "address": "http://astra.example.com:8000/play/lab1" }, { "id": "", "name": "Lab Three", "channel_path": "labthree", "address": "http://astra.example.com:8000/play/lab3" }, { "id": "", "name": "Lab Two", "channel_path": "labtwo", "address": "http://astra.example.com:8000/play/lab2" }]Os itens voltaram com o id vazio, então envie os que você quer com chaves próprias:
curl -sS -X PUT -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/receiver/importm3u' \ -d '{"1": {"name": "Lab One", "channel_path": "labone", "address": "http://astra.example.com:8000/play/lab1"}, "2": {"name": "Lab Three", "channel_path": "labthree", "address": "http://astra.example.com:8000/play/lab3"}}'O Alta criou o receptor e o canal labthree/main. Ele respondeu 200 com o item que pulou: Lab One já tinha um receptor com a mesma fonte. Sem itens pulados a resposta é 204. Os receptores importados ficam desativados: ative-os com a API de receptores.
8. Se o Astra reiniciar
Seção intitulada “8. Se o Astra reiniciar”No laboratório o Astra foi parado por 8 segundos e iniciado de novo. O Alta continuou tentando a fonte e o receptor voltou em menos de 20 segundos depois de o Astra iniciar de novo, sem nenhuma ação nossa. Enquanto um receptor não recebe stream, o cartão do canal dele no Dashboard fica vermelho.
O que vem depois
Seção intitulada “O que vem depois”- Um canal sem autorizador é público. Configure a Autorização HTTP no Alta.
- Para set-top boxes com middleware leia Integração com o Middleware Ministra (Stalker).
- Para adicionar um segundo bitrate ao canal, leia Dois bitrates para um canal: Alta com Senta.