Estes guias mapeiam os conceitos de um setor para os objetos que a plataforma tem hoje (bouquets, lines, pacotes, contas de parceiro, nodes, a API). São mapeamentos conceituais, não recursos específicos de um setor, e uma conta de parceiro é uma conta delegada, não um tenant isolado.
Mapeamento conceitual
Nada no painel se chama palco ou ingresso. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Canal do palco | Canal ao vivo: um stream com suas fontes, EPG e formatos de saída | Streams → adicionar um stream ao vivo (URL de origem ou envio por RTMP) |
| Tipo de ingresso | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Ingresso ou passe | Line: um acesso com seu pacote, bouquets, expiração, limite de conexões e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Fim do evento | Data de expiração da line, renovada por um pacote, um crédito ou a API | A data de expiração da line e a duração do pacote |
| Dispositivos por ingresso | Máximo de conexões da line: quantos dispositivos podem assistir ao mesmo tempo | O máximo de conexões da line |
| Integração com ingressos ou inscrição | Reseller API e webhooks: as operações do painel a partir do seu próprio sistema | Chaves da Reseller API e webhooks no painel do revendedor |
| Node do local | Nodes de streaming: servidores de borda registrados pelo painel, um por local ou prédio | Servers → adicionar um node, instalado por SSH |
Pré-requisitos
O que ter antes de instalar.
- Um servidor (Ubuntu 22.04 ou 24.04) com endereço público ou um domínio e uplink para o pico de público esperado e, para um node no local, uma máquina na rede do local.
- Um encoder por palco capaz de fazer push RTMP e a lista de palcos, dias e tipos de ingresso.
- Uma decisão sobre como os ingressos chegam ao painel: códigos de ativação gerados em massa, ou o sistema de ingressos chamando a Reseller API.
Implantação da infraestrutura
Primeiro a origem, depois o local.
- Execute o instalador no servidor de gerenciamento e coloque o painel atrás de um proxy reverso com TLS; defina os proxies confiáveis para que as regras de IP vejam o endereço real do espectador.
- Defina a URL base de reprodução com o endereço público que os participantes acessam.
- Registre um node em Servidores na máquina do local; o painel o instala por SSH e as telas locais são direcionadas a ele.
- Crie uma conta de parceiro (revendedor) para a bilheteria, com permissões para linhas e nenhuma para o catálogo.
Organização do conteúdo
Palcos como canais, ingressos como pacotes.
- Adicione categorias por dia ou por trilha para que a lista de canais se leia como a programação.
- Crie um bouquet por tipo de ingresso: os palcos que esse ingresso pode assistir.
- Crie um pacote por tipo de ingresso com a duração do evento como duração e um pacote de teste para imprensa e palestrantes, se necessário.
- Crie um bouquet para o sinal do palco ou do lounge dos patrocinadores e conceda-o apenas pelo pacote de patrocinador.
Configuração de parceiros (revendedores)
A bilheteria, se ela emitir o acesso.
- Crie um grupo com permissões de linhas e sem permissões de catálogo para a bilheteria.
- Adicione a bilheteria como revendedor com esse grupo e créditos suficientes para os códigos que emitirá.
- Um coorganizador ou parceiro regional que vende os próprios ingressos recebe sua própria conta de parceiro e seus próprios pacotes.
Configuração do acesso dos participantes
Uma linha por ingresso.
- Gere códigos de ativação em massa, um por ingresso, cada um vinculado ao pacote do seu tipo de ingresso, e imprima-os ou envie-os por e-mail junto com o ingresso.
- Para a venda online de ingressos, instale o conector da sua plataforma de e-commerce ou faça o sistema de ingressos chamar action=create_line com o pacote e um id de requisição.
- Defina o máximo de conexões como um ou dois dispositivos por ingresso, para que um código não seja compartilhado com todo o público.
- Teste com uma linha de teste antes de abrirem as portas, usando o mesmo player que os participantes usarão.
Gravações das sessões
Gravações depois do evento.
- Grave cada palco e adicione os arquivos à biblioteca como episódios de uma série por trilha, ou ingira-os com o job de ingestão de VOD.
- Conceda as gravações por meio de um bouquet e um pacote próprios, para que os participantes mantenham o acesso depois que as linhas do ao vivo expirarem.
- Verifique a reprodução das gravações com uma linha de teste desse pacote antes de anunciá-las.
Canais dos palcos
Um palco como canal ao vivo.
- Adicione um stream ao vivo por palco com o push RTMP do encoder e coloque-o nos bouquets dos tipos de ingresso que podem assisti-lo.
- Ative o catch-up para que um participante que perdeu o início de uma sessão possa voltar no tempo.
- Verifique antes da primeira sessão que o node do local pega cada palco uma única vez da origem e que as telas estão direcionadas a ele.
Vencimento
O acesso termina com o evento.
- Dê a cada pacote de ingresso uma duração que termine no último dia do evento, para que as linhas expirem sem nenhum trabalho.
- Estenda uma linha, ou emita um código de curta duração, para um palestrante ou um patrocinador de última hora em vez de criar um novo pacote.
- Desative em Linhas a linha de um ingresso perdido ou compartilhado; o log de auditoria guarda o histórico.
Integração com o sistema de ingressos
Os sistemas controlam o acesso; o player reproduz.
- O sistema de ingressos ou inscrição cria linhas pela Reseller API e escuta webhooks como line.created e line.expired.
- A venda online de ingressos em uma plataforma de e-commerce compatível usa o conector dela; não há conector nativo para um produto de ingressos específico.
- Não há login único para espectadores: um participante entra no player com as credenciais da linha ou com um código de ativação.
Considerações de segurança
Um ingresso é uma pessoa.
- Sirva o painel e a URL base de reprodução com TLS e defina TRUSTED_PROXIES com o seu proxy reverso.
- Login em duas etapas para toda conta do painel e grupos de permissões para que a bilheteria não possa alterar os palcos.
- Links de reprodução assinados e com expiração e um limite baixo de conexões por ingresso.
- Backups criptografados do banco de dados com cópia externa e o log de auditoria para cada alteração de linhas e palcos.
Solução de problemas
As primeiras verificações habituais.
- Um participante não consegue abrir um palco: verifique o pacote da linha, o bouquet que contém o palco e a data de vencimento.
- Um palco trava na sala mas não online: verifique o heartbeat do node do local e a rota das telas até ele.
- Um código de ativação é recusado: verifique se ele já não foi usado e se o pacote dele ainda é válido.
- O log de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES com o proxy e reinicie o painel.