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 sala o socio. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Film della mostra e archivio | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Diretta di inaugurazione o conferenza | 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) |
| Collezione delle sale o dei soci | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Accesso di visitatore o socio | 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 |
| Periodo di iscrizione | 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 socio | Connessioni massime della linea: quanti dispositivi possono guardare insieme | Le connessioni massime della linea |
Prerequisiti
Cosa avere prima di installare.
- Un server nell'edificio (Ubuntu 22.04 o 24.04), l'installer e la rete delle sale che useranno gli schermi e i dispositivi dei soci.
- Il film della mostra, le registrazioni d'archivio di cui detieni i diritti, un encoder per l'auditorium e gli schermi o i media player per le sale.
- La chiave di licenza e, se l'edificio non ha internet, la procedura di attivazione offline; e una decisione su chi alla biglietteria vende le iscrizioni.
Installazione dell'infrastruttura
Il server nell'edificio, attivato in loco.
- Esegui l'installer sul server e imposta l'URL base di riproduzione sull'indirizzo raggiunto dalla rete delle sale.
- Attiva la chiave di licenza offline dal pannello; dopo l'attivazione il servizio gira sulla rete locale senza internet.
- Aggiungi il film della mostra in Film e il segnale dell'auditorium in Stream, e controllali nel web player.
- Per una seconda sede o un grande programma pubblico, registra un nodo da Server; il pannello lo installa via SSH e vi instrada gli spettatori di quella sede.
Organizzazione dei contenuti
Sale, archivio e collezioni dei soci.
- Crea categorie per mostra e per anno, e una serie per un ciclo di conferenze con un episodio per intervento.
- Crea un bouquet per gli schermi delle sale e uno per la libreria dei soci con conferenze e film d'archivio.
- Crea un pacchetto per le sale e uno per tipo di iscrizione, ciascuno con i propri bouquet; la durata del pacchetto di iscrizione è il periodo di iscrizione.
- Aggiungi locandine e brevi descrizioni a ogni film così la libreria si legge bene nel player.
Configurazione dei partner (reseller)
La biglietteria e il negozio come account delegati.
- Crea un gruppo con permessi limitati a linee e codici di attivazione, senza accesso al catalogo né ai server.
- Aggiungi la biglietteria, o il negozio, come reseller con quel gruppo, i pacchetti di iscrizione e un saldo di crediti.
- Un centro culturale che gestisce più sedi può aggiungere un reseller per sede, ciascuno che vende iscrizioni con il proprio saldo.
Configurazione dell'accesso di visitatori e soci
Schermi e soci su linee.
- Crea una linea per schermo di sala in Linee → aggiungi con il pacchetto delle sale e associala all'indirizzo dello schermo quando la rete assegna indirizzi fissi.
- Crea alla biglietteria i codici di attivazione per ogni iscrizione venduta; il socio inserisce il codice nel player e la linea parte.
- Imposta le connessioni massime per iscrizione sul numero di dispositivi che un socio può usare, di solito due.
- Consegna al socio l'app player, una playlist M3U o l'indirizzo del web player, a seconda di ciò che si adatta al suo dispositivo.
Film della mostra e archivio
La libreria on demand.
- Carica il film della mostra e l'archivio digitalizzato come film, oppure importali con il job di ingest VOD nella root dei media.
- Aggiungi i metadati TMDB dove esistono e scrivi tu titolo e descrizione per il resto.
- Tieni l'archivio non destinato al pubblico solo nel bouquet dei soci e verifica con una linea di test cosa vede ogni pacchetto.
Inaugurazioni e conferenze
Un evento come canale live.
- Aggiungi uno stream live per l'encoder dell'auditorium (invio RTMP) e inseriscilo nel bouquet dei soci, o nel bouquet delle sale per un'inaugurazione mostrata sugli schermi.
- Attiva il catch-up così un socio che arriva in ritardo può tornare indietro, e carica poi la registrazione nella libreria.
- Prova l'encoder e lo stream prima dell'evento con una linea di test, sulla stessa rete che userà il pubblico.
Scadenza e rinnovo dell'iscrizione
L'iscrizione come validità della linea.
- Una linea scade alla fine del periodo del suo pacchetto; un rinnovo alla biglietteria aggiunge un altro periodo.
- Disattiva una linea quando un'iscrizione viene annullata; i codici di attivazione mai usati restano inutilizzati finché non vengono riscattati.
- Iscrivi il negozio o il sistema di iscrizioni ai webhook per vedere le linee che stanno per scadere o già scadute.
Integrazione con il negozio o il sistema di iscrizioni
I sistemi vendono l'accesso; il player riproduce.
- Crea una chiave Reseller API per il negozio o il sistema di iscrizioni; chiama create_line, renew_line e disable_line, con un id della richiesta a ogni scrittura.
- Usa un connettore e-commerce quando le iscrizioni si vendono online; qualsiasi altro sistema usa la Reseller API e i webhook.
- Non esiste il single sign-on per gli spettatori: un socio accede al player con le credenziali della linea o con il codice di attivazione.
Considerazioni sulla sicurezza
Tieni le collezioni dove devono stare.
- Tieni la rete delle sale separata dalla rete dei visitatori e servi ogni accesso pubblico dietro un reverse proxy con TLS e TRUSTED_PROXIES impostato.
- Accesso a due fattori per ogni account del pannello; la biglietteria riceve un gruppo di permessi limitato a linee e codici.
- Link di riproduzione firmati e con scadenza, un limite di connessioni per iscrizione e associazione a indirizzo per gli schermi delle sale.
- Attiva il backup cifrato del database con una copia esterna e usa il registro di audit per rivedere le modifiche di linee e catalogo.
Risoluzione dei problemi
I primi controlli abituali.
- Uno schermo di sala è nero: controlla che la sua linea sia attiva e non scaduta, l'associazione a indirizzo dello schermo e che il server sia raggiungibile sulla rete delle sale.
- Il codice di un socio non funziona: controlla che il codice non sia già stato riscattato e che il pacchetto che apre sia ancora assegnato alla biglietteria.
- L'attivazione della licenza offline non riesce: controlla il file di attivazione rispetto alla chiave di licenza e l'orologio del server.
- L'inaugurazione live scatta: controlla il bitrate dell'encoder rispetto all'uplink e lo stato dello stream in Stream.