Estes guias fazem corresponder os conceitos de um setor aos objetos que a plataforma tem hoje (bouquets, linhas, pacotes, contas de parceiro, nós, a API). São correspondências conceptuais, não funcionalidades específicas de um setor, e uma conta de parceiro é uma conta delegada, não um inquilino isolado.
Correspondência conceptual
Nada no painel se chama galeria ou membro. A tabela diz que objeto desempenha que papel; os capítulos abaixo configuram-nos por essa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Filme da exposição e arquivo | Catálogo VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão VOD |
| Transmissão de inauguração ou palestra | Canal em direto: um stream com as suas fontes, EPG e formatos de saída | Streams → adicionar um stream em direto (URL de origem ou envio 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 | Linha: um acesso com o seu pacote, bouquets, validade, limite de ligações e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Período de adesão | Data de validade da linha, renovada por um pacote, um crédito ou pela API | A data de validade da linha e a duração do pacote |
| Dispositivos por membro | Máximo de ligações da linha: quantos dispositivos podem ver em simultâneo | O máximo de ligações da linha |
Pré-requisitos
O que ter antes de instalar.
- Um servidor no edifício (Ubuntu 22.04 ou 24.04), o instalador e a rede das galerias que os ecrãs e os dispositivos dos membros vão usar.
- O filme da exposição, as gravações de arquivo de que detém os direitos, um codificador para o auditório e os ecrãs ou media players das galerias.
- A chave de licença e, se o edifício não tiver internet, o procedimento de ativação offline; e uma decisão sobre quem na bilheteira vende as adesões.
Implementação da infraestrutura
O servidor no edifício, ativado no local.
- Execute o instalador no servidor e defina o URL base de reprodução para o endereço que a rede das galerias alcança.
- Ative a chave de licença offline a partir do painel; após a ativação, o serviço corre na rede local sem internet.
- Adicione o filme da exposição em Movies e o feed do auditório em Streams e verifique-os no leitor web.
- Para um segundo local ou um grande programa público, registe um nó em Servers; o painel instala-o por SSH e encaminha para ele os espectadores desse local.
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 os ecrãs 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 adesão, cada um a conceder os seus bouquets; a duração do pacote de adesão é o período da adesão.
- Adicione cartazes e breves descrições a todos os filmes para que a biblioteca fique bem apresentada no leitor.
Configuração de parceiros (revendedores)
A bilheteira 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 a bilheteira, ou a loja, como revendedor com esse grupo, os pacotes de adesão e um saldo de créditos.
- Um centro cultural com vários espaços pode adicionar um revendedor por espaço, cada um a vender adesões com o seu próprio saldo.
Configuração do acesso de visitantes e membros
Ecrãs e membros em linhas.
- Crie uma linha por ecrã de galeria em Lines → add com o pacote da galeria e associe-a ao endereço do ecrã quando a rede atribui endereços fixos.
- Crie códigos de ativação na bilheteira para cada adesão vendida; o membro introduz o código no leitor e a linha começa.
- Defina o máximo de ligações por adesão como o número de dispositivos que um membro pode usar, normalmente dois.
- Entregue ao membro a aplicação de leitor, uma lista M3U ou o endereço do leitor web, o que se adequar ao seu dispositivo.
Filme da exposição e arquivo
A biblioteca a pedido.
- Carregue o filme da exposição e o arquivo digitalizado como filmes, ou ingira-os com a tarefa de ingestão de VOD na raiz de media.
- Adicione metadados do TMDB quando existirem e escreva por si 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 vê com uma linha de teste.
Inaugurações e palestras
Um evento como canal em direto.
- Adicione um stream em direto para o codificador do auditório (envio RTMP) e coloque-o no bouquet dos membros, ou no bouquet das galerias para uma inauguração mostrada nos ecrãs.
- Ative o catch-up para que um membro que chega tarde possa recuar e carregue a gravação para a biblioteca depois.
- Teste o codificador e o stream antes do evento com uma linha de teste, na mesma rede que o público vai usar.
Validade e renovação da adesão
A adesão como validade da linha.
- Uma linha expira no fim do período do seu pacote; uma renovação na bilheteira soma outro período.
- Desative uma linha quando uma adesão for cancelada; os códigos de ativação nunca usados permanecem por usar até serem resgatados.
- Subscreva a loja ou o sistema de adesão nos webhooks para ver linhas prestes a expirar ou já expiradas.
Integração com a loja ou o sistema de adesão
Os sistemas vendem o acesso; o leitor reproduz.
- Crie uma chave da Reseller API para a loja ou o sistema de adesão; este chama create_line, renew_line e disable_line, com um id de pedido em cada escrita.
- Use um conector de comércio eletrónico quando as adesões forem vendidas online; qualquer outro sistema usa a Reseller API e webhooks.
- Não há início de sessão único para espectadores: um membro entra no leitor 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 inverso com TLS e TRUSTED_PROXIES definido.
- Início de sessão com dois fatores para todas as contas do painel; a bilheteira recebe um grupo de permissões limitado a linhas e códigos.
- Ligações de reprodução assinadas e com expiração, um limite de ligações por adesão e associação de endereço para os ecrãs das galerias.
- Ative a cópia de segurança cifrada da base de dados com cópia externa e use o registo de auditoria para rever alterações de linhas e do catálogo.
Resolução de problemas
As primeiras verificações habituais.
- Um ecrã de galeria está preto: verifique se a sua linha está ativada e não expirada, a associação de endereço do ecrã e se o servidor é alcançá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 abre ainda está atribuído à bilheteira.
- A ativação da licença falha offline: verifique o ficheiro de ativação em relação à chave de licença e ao relógio do servidor.
- A inauguração em direto engasga: verifique o bitrate do codificador em relação ao uplink e o estado do stream em Streams.