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 palco ou bilhete. 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 |
|---|---|---|
| Canal do palco | 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) |
| Tipo de bilhete | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Bilhete ou passe | 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 |
| Fim do evento | 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 bilhete | Máximo de ligações da linha: quantos dispositivos podem ver em simultâneo | O máximo de ligações da linha |
| Integração com bilhética 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 |
| Nó do local | Nós de streaming: servidores edge registados a partir do painel, um por local ou edifício | Servers → adicionar um nó, 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 nó no local, uma máquina na rede do local.
- Um codificador por palco capaz de enviar RTMP e a lista de palcos, dias e tipos de bilhete.
- Uma decisão sobre como os bilhetes chegam ao painel: códigos de ativação gerados em massa, ou o sistema de bilhética a chamar a Reseller API.
Implementação da infraestrutura
Primeiro a origem, depois o local.
- Execute o instalador no servidor de gestão e coloque o painel atrás de um proxy inverso com TLS; defina os proxies de confiança para que as regras de IP vejam o endereço real do espectador.
- Defina o URL base de reprodução para o endereço público que os participantes acedem.
- Registe um nó em Servers na máquina do local; o painel instala-o por SSH e os ecrãs locais são encaminhados para ele.
- Crie uma conta de parceiro (revendedor) para a bilheteira, com permissões para linhas e nenhuma para o catálogo.
Organização do conteúdo
Palcos como canais, bilhetes como pacotes.
- Adicione categorias por dia ou por trilho para que a lista de canais se leia como o programa.
- Crie um bouquet por tipo de bilhete: os palcos que esse bilhete pode ver.
- Crie um pacote por tipo de bilhete com a duração do evento como duração e um pacote de teste para imprensa e oradores, se necessário.
- Crie um bouquet para o feed do palco ou do lounge dos patrocinadores e conceda-o apenas através do pacote de patrocinador.
Configuração de parceiros (revendedores)
A bilheteira, se ela emitir o acesso.
- Crie um grupo com permissões de linhas e sem permissões de catálogo para a bilheteira.
- Adicione a bilheteira como revendedor com esse grupo e créditos suficientes para os códigos que emitirá.
- Um coorganizador ou parceiro regional que vende os seus próprios bilhetes recebe a sua própria conta de parceiro e os seus próprios pacotes.
Configuração do acesso dos participantes
Uma linha por bilhete.
- Gere códigos de ativação em massa, um por bilhete, cada um associado ao pacote do seu tipo de bilhete, e imprima-os ou envie-os por e-mail com o bilhete.
- Para a venda online de bilhetes, instale o conector da sua plataforma de comércio eletrónico ou faça o sistema de bilhética chamar action=create_line com o pacote e um id de pedido.
- Defina o máximo de ligações como um ou dois dispositivos por bilhete, para que um código não seja partilhado com todo o público.
- Teste com uma linha de teste antes de as portas abrirem, usando o mesmo leitor que os participantes vão usar.
Gravações das sessões
Gravações depois do evento.
- Grave cada palco e adicione os ficheiros à biblioteca como episódios de uma série por trilho, ou ingira-os com a tarefa de ingestão de VOD.
- Conceda as gravações através de um bouquet e um pacote próprios, para que os participantes mantenham o acesso depois de as linhas do direto expirarem.
- Verifique a reprodução das gravações com uma linha de teste desse pacote antes de as anunciar.
Canais dos palcos
Um palco como canal em direto.
- Adicione um stream em direto por palco com o envio RTMP do codificador e coloque-o nos bouquets dos tipos de bilhete que o podem ver.
- Ative o catch-up para que um participante que perdeu o início de uma sessão possa recuar.
- Verifique antes da primeira sessão que o nó do local obtém cada palco uma só vez da origem e que os ecrãs estão encaminhados para ele.
Validade
O acesso termina com o evento.
- Dê a cada pacote de bilhete uma duração que termine no último dia do evento, para que as linhas expirem sem qualquer trabalho.
- Prolongue uma linha, ou emita um código de curta duração, para um orador ou um patrocinador de última hora em vez de criar um novo pacote.
- Desative em Lines a linha de um bilhete perdido ou partilhado; o registo de auditoria guarda o histórico.
Integração com a bilhética
Os sistemas controlam o acesso; o leitor reproduz.
- O sistema de bilhética ou inscrição cria linhas através da Reseller API e escuta webhooks como line.created e line.expired.
- A venda online de bilhetes numa plataforma de comércio eletrónico suportada usa o seu conector; não há conector nativo para um produto de bilhética específico.
- Não há início de sessão único para espectadores: um participante entra no leitor com as credenciais da linha ou com um código de ativação.
Considerações de segurança
Um bilhete é uma pessoa.
- Sirva o painel e o URL base de reprodução por TLS e defina TRUSTED_PROXIES para o seu proxy inverso.
- Início de sessão com dois fatores para todas as contas do painel e grupos de permissões para que a bilheteira não possa alterar os palcos.
- Ligações de reprodução assinadas e com expiração e um limite baixo de ligações por bilhete.
- Cópias de segurança cifradas da base de dados com cópia externa e o registo de auditoria para cada alteração de linhas e palcos.
Resoluçã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 validade.
- Um palco bloqueia na sala mas não online: verifique o heartbeat do nó do local e a rota dos ecrãs até ele.
- Um código de ativação é recusado: verifique se já não foi usado e se o seu pacote ainda é válido.
- O registo de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES para o proxy e reinicie o painel.