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 galeria ou membro. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Filme da exposição e arquivo | Catálogo de VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão de VOD |
| Transmissão de abertura ou palestra | 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) |
| Coleção da galeria ou dos membros | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Acesso de visitante ou membro | 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 |
| Período de associação | 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 membro | Máximo de conexões da line: quantos dispositivos podem assistir ao mesmo tempo | O máximo de conexões da line |
Pré-requisitos
O que ter antes de instalar.
- Um servidor no prédio (Ubuntu 22.04 ou 24.04), o instalador e a rede das galerias que as telas e os dispositivos dos membros usarão.
- O filme da exposição, as gravações de arquivo para as quais você tem os direitos, um encoder para o auditório e as telas ou media players das galerias.
- A chave de licença e, se o prédio não tiver internet, o procedimento de ativação offline; e uma decisão sobre quem no balcão vende as associações.
Implantação da infraestrutura
O servidor no prédio, ativado no local.
- Execute o instalador no servidor e defina a URL base de reprodução como o endereço que a rede das galerias acessa.
- Ative a chave de licença offline pelo painel; depois da ativação, o serviço roda na rede local sem internet.
- Adicione o filme da exposição em Filmes e o sinal do auditório em Streams e verifique-os no player web.
- Para uma segunda unidade ou um grande programa público, registre um node em Servidores; o painel o instala por SSH e direciona os espectadores dessa unidade a ele.
Organização do conteúdo
Galerias, arquivo e coleções de membros.
- Crie categorias por exposição e por ano e uma série para um ciclo de palestras, com um episódio por palestra.
- Crie um bouquet para as telas das galerias e um para a biblioteca de membros com palestras e filmes de arquivo.
- Crie um pacote para as galerias e um por tipo de associação, cada um concedendo seus bouquets; a duração do pacote de associação é o período da associação.
- Adicione pôsteres e breves descrições a todos os filmes para que a biblioteca fique bem apresentada no player.
Configuração de parceiros (revendedores)
O balcão e a loja como contas delegadas.
- Crie um grupo com permissões limitadas a linhas e códigos de ativação, sem acesso ao catálogo nem aos servidores.
- Adicione o balcão, ou a loja, como revendedor com esse grupo, os pacotes de associação e um saldo de créditos.
- Um centro cultural com vários locais pode adicionar um revendedor por local, cada um vendendo associações com seu próprio saldo.
Configuração do acesso de visitantes e membros
Telas e membros em linhas.
- Crie uma linha por tela de galeria em Linhas → adicionar com o pacote da galeria e vincule-a ao endereço da tela quando a rede der endereços fixos.
- Crie códigos de ativação no balcão para cada associação vendida; o membro digita o código no player e a linha começa.
- Defina o máximo de conexões por associação como o número de dispositivos que um membro pode usar, normalmente dois.
- Entregue ao membro o app player, uma playlist M3U ou o endereço do player web, o que for adequado ao dispositivo dele.
Filme da exposição e arquivo
A biblioteca sob demanda.
- Envie o filme da exposição e o arquivo digitalizado como filmes, ou ingira-os com o job de ingestão de VOD na raiz de mídia.
- Adicione metadados do TMDB quando existirem e escreva você mesmo o título e a descrição do restante.
- Mantenha o arquivo que não é para o público apenas no bouquet dos membros e verifique o que cada pacote enxerga com uma linha de teste.
Aberturas e palestras
Um evento como canal ao vivo.
- Adicione um stream ao vivo para o encoder do auditório (push RTMP) e coloque-o no bouquet dos membros, ou no bouquet das galerias para uma abertura exibida nas telas.
- Ative o catch-up para que um membro que chega atrasado possa voltar no tempo e envie a gravação para a biblioteca depois.
- Teste o encoder e o stream antes do evento com uma linha de teste, na mesma rede que o público usará.
Vencimento e renovação da associação
A associação como validade da linha.
- Uma linha expira no fim do período do seu pacote; uma renovação no balcão soma outro período.
- Desative uma linha quando uma associação for cancelada; códigos de ativação nunca usados permanecem sem uso até serem resgatados.
- Inscreva a loja ou o sistema de associação nos webhooks para ver linhas prestes a expirar ou já expiradas.
Integração com a loja ou o sistema de associação
Os sistemas vendem o acesso; o player reproduz.
- Crie uma chave da Reseller API para a loja ou o sistema de associação; ele chama create_line, renew_line e disable_line, com um id de requisição em cada escrita.
- Use um conector de e-commerce quando as associações forem vendidas online; qualquer outro sistema usa a Reseller API e webhooks.
- Não há login único para espectadores: um membro entra no player com as credenciais da linha ou com o código de ativação.
Considerações de segurança
Mantenha as coleções onde devem estar.
- Mantenha a rede das galerias separada da rede dos visitantes e sirva qualquer acesso público atrás de um proxy reverso com TLS e TRUSTED_PROXIES definido.
- Login em duas etapas para toda conta do painel; o balcão recebe um grupo de permissões limitado a linhas e códigos.
- Links de reprodução assinados e com expiração, um limite de conexões por associação e vínculo de endereço para as telas das galerias.
- Ative o backup criptografado do banco de dados com cópia externa e use o log de auditoria para revisar alterações de linhas e do catálogo.
Solução de problemas
As primeiras verificações habituais.
- Uma tela de galeria está preta: verifique se a linha dela está ativada e não expirada, o vínculo de endereço da tela e se o servidor está acessível na rede das galerias.
- O código de um membro não funciona: verifique se o código já não foi resgatado e se o pacote que ele abre ainda está atribuído ao balcão.
- A ativação da licença falha offline: verifique o arquivo de ativação em relação à chave de licença e ao relógio do servidor.
- A abertura ao vivo engasga: verifique o bitrate do encoder em relação ao uplink e o status do stream em Streams.