Queste guide mettono in corrispondenza i concetti di un settore con gli oggetti che la piattaforma ha oggi (bouquet, linee, pacchetti, account partner, nodi, l'API). Sono corrispondenze concettuali, non funzioni specifiche per settore, e un account partner è un account delegato, non un tenant isolato.
Corrispondenza concettuale
Nel pannello nulla si chiama palco o biglietto. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Canale del palco | Canale in diretta: uno stream con le sue fonti, l'EPG e i formati di uscita | Streams → aggiungi uno stream in diretta (URL della fonte o push RTMP) |
| Tipo di biglietto | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Biglietto o pass | Linea: un accesso con il suo pacchetto, i bouquet, la scadenza, il limite di connessioni e le uscite | Lines → aggiungi, oppure codici di attivazione, oppure la Reseller API |
| Fine dell'evento | Data di scadenza della linea, rinnovata da un pacchetto, da un credito o dall'API | La data di scadenza della linea e la durata del pacchetto |
| Dispositivi per biglietto | Connessioni massime della linea: quanti dispositivi possono guardare insieme | Le connessioni massime della linea |
| Integrazione con biglietteria o registrazione | Reseller API e webhook: le operazioni del pannello dal tuo sistema | Chiavi Reseller API e webhook nella dashboard del reseller |
| Nodo della sede | Nodi di streaming: server edge registrati dal pannello, uno per sede o edificio | Servers → aggiungi un nodo, installato via SSH |
Prerequisiti
Cosa avere prima di installare.
- Un server (Ubuntu 22.04 o 24.04) con un indirizzo pubblico o un dominio e un uplink adeguato al picco di pubblico previsto e, per un nodo nella sede, una macchina sulla rete della sede.
- Un encoder per palco in grado di inviare RTMP, e l'elenco di palchi, giorni e tipi di biglietto.
- Una decisione su come i biglietti arrivano al pannello: codici di attivazione generati in blocco, o il sistema di biglietteria che chiama la Reseller API.
Installazione dell'infrastruttura
Prima l'origine, poi la sede.
- Esegui l'installer sul server di gestione e metti il pannello dietro un reverse proxy con TLS; imposta i proxy attendibili così le regole IP vedono l'indirizzo reale dello spettatore.
- Imposta l'URL base di riproduzione sull'indirizzo pubblico raggiunto dai partecipanti.
- Registra da Server un nodo sulla macchina della sede; il pannello lo installa via SSH e gli schermi locali vi vengono instradati.
- Crea un account partner (reseller) per la biglietteria con permessi sulle linee e nessuno sul catalogo.
Organizzazione dei contenuti
Palchi come canali, biglietti come pacchetti.
- Aggiungi categorie per giorno o per percorso così l'elenco dei canali si legge come il programma.
- Crea un bouquet per tipo di biglietto: i palchi che quel biglietto può vedere.
- Crea un pacchetto per tipo di biglietto con la durata dell'evento come durata, e un pacchetto di prova per stampa e relatori se serve.
- Crea un bouquet per il segnale del palco o della lounge degli sponsor e concedilo solo tramite il pacchetto sponsor.
Configurazione dei partner (reseller)
La biglietteria, se emette gli accessi.
- Crea un gruppo con permessi sulle linee e senza permessi sul catalogo per la biglietteria.
- Aggiungi la biglietteria come reseller con quel gruppo e crediti sufficienti per i codici che emetterà.
- Un co-organizzatore o un partner regionale che vende i propri biglietti riceve un proprio account partner e propri pacchetti.
Configurazione dell'accesso dei partecipanti
Una linea per biglietto.
- Genera codici di attivazione in blocco, uno per biglietto, ciascuno legato al pacchetto del suo tipo di biglietto, e stampali o inviali per e-mail con il biglietto.
- Per la vendita online dei biglietti, installa il connettore della tua piattaforma e-commerce, oppure fai chiamare al sistema di biglietteria action=create_line con il pacchetto e un id della richiesta.
- Imposta le connessioni massime su uno o due dispositivi per biglietto, così un codice non può essere condiviso con tutto il pubblico.
- Prova con una linea di test prima dell'apertura delle porte, usando lo stesso player che useranno i partecipanti.
Registrazioni delle sessioni
Registrazioni dopo l'evento.
- Registra ogni palco e aggiungi i file alla libreria come episodi di una serie per percorso, oppure importali con il job di ingest VOD.
- Concedi le registrazioni tramite un bouquet e un pacchetto dedicati, così i partecipanti mantengono l'accesso dopo la scadenza delle linee live.
- Verifica la riproduzione delle registrazioni con una linea di test di quel pacchetto prima di annunciarle.
Canali dei palchi
Un palco come canale live.
- Aggiungi uno stream live per palco con l'invio RTMP dell'encoder e inseriscilo nei bouquet dei tipi di biglietto che possono guardarlo.
- Attiva il catch-up così un partecipante che ha perso l'inizio di una sessione può tornare indietro.
- Verifica prima della prima sessione che il nodo della sede prelevi ogni palco una sola volta dall'origine e che gli schermi vi siano instradati.
Scadenza
L'accesso termina con l'evento.
- Dai a ogni pacchetto di biglietto una durata che termini con l'ultimo giorno dell'evento, così le linee scadono senza alcun lavoro.
- Estendi una linea, o emetti un codice a breve durata, per un relatore o uno sponsor dell'ultimo minuto invece di creare un nuovo pacchetto.
- Disattiva da Linee la linea di un biglietto perso o condiviso; il registro di audit ne conserva la traccia.
Integrazione con la biglietteria
I sistemi gestiscono l'accesso; il player riproduce.
- Il sistema di biglietteria o di registrazione crea le linee tramite la Reseller API e ascolta webhook come line.created e line.expired.
- La vendita online dei biglietti su una piattaforma e-commerce supportata usa il suo connettore; non esiste un connettore nativo per uno specifico prodotto di biglietteria.
- Non esiste il single sign-on per gli spettatori: un partecipante accede al player con le credenziali della linea o con un codice di attivazione.
Considerazioni sulla sicurezza
Un biglietto è una persona.
- Servi il pannello e l'URL base di riproduzione via TLS e imposta TRUSTED_PROXIES sul tuo reverse proxy.
- Accesso a due fattori per ogni account del pannello e gruppi di permessi perché la biglietteria non possa modificare i palchi.
- Link di riproduzione firmati e con scadenza e un limite di connessioni basso per biglietto.
- Backup cifrati del database con una copia esterna e il registro di audit per ogni modifica di linee e palchi.
Risoluzione dei problemi
I primi controlli abituali.
- Un partecipante non riesce ad aprire un palco: controlla il pacchetto della linea, il bouquet che contiene il palco e la data di scadenza.
- Un palco si blocca in sala ma non online: controlla l'heartbeat del nodo della sede e il percorso degli schermi verso di esso.
- Un codice di attivazione viene rifiutato: controlla che non sia già stato usato e che il suo pacchetto sia ancora valido.
- Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.