Home
XtreamUIPro

Guida alla configurazione

Guida alla configurazione per gli eventi live

Configura la piattaforma come servizio di streaming di una conferenza, un festival o una cerimonia: un canale per palco, accesso per biglietto, un nodo nella sede e scadenze brevi.

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 settoreSulla piattaformaDove nel pannello
Canale del palcoCanale in diretta: uno stream con le sue fonti, l'EPG e i formati di uscitaStreams → aggiungi uno stream in diretta (URL della fonte o push RTMP)
Tipo di bigliettoBouquet: un insieme con nome di canali, film o serie che un pacchetto concedeBouquets, a partire da Streams e Movies / Series
Biglietto o passLinea: un accesso con il suo pacchetto, i bouquet, la scadenza, il limite di connessioni e le usciteLines → aggiungi, oppure codici di attivazione, oppure la Reseller API
Fine dell'eventoData di scadenza della linea, rinnovata da un pacchetto, da un credito o dall'APILa data di scadenza della linea e la durata del pacchetto
Dispositivi per bigliettoConnessioni massime della linea: quanti dispositivi possono guardare insiemeLe connessioni massime della linea
Integrazione con biglietteria o registrazioneReseller API e webhook: le operazioni del pannello dal tuo sistemaChiavi Reseller API e webhook nella dashboard del reseller
Nodo della sedeNodi di streaming: server edge registrati dal pannello, uno per sede o edificioServers → aggiungi un nodo, installato via SSH

Prerequisiti

Cosa avere prima di installare.

  1. 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.
  2. Un encoder per palco in grado di inviare RTMP, e l'elenco di palchi, giorni e tipi di biglietto.
  3. 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.

  1. 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.
  2. Imposta l'URL base di riproduzione sull'indirizzo pubblico raggiunto dai partecipanti.
  3. Registra da Server un nodo sulla macchina della sede; il pannello lo installa via SSH e gli schermi locali vi vengono instradati.
  4. 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.

  1. Aggiungi categorie per giorno o per percorso così l'elenco dei canali si legge come il programma.
  2. Crea un bouquet per tipo di biglietto: i palchi che quel biglietto può vedere.
  3. 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.
  4. 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.

  1. Crea un gruppo con permessi sulle linee e senza permessi sul catalogo per la biglietteria.
  2. Aggiungi la biglietteria come reseller con quel gruppo e crediti sufficienti per i codici che emetterà.
  3. 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.

  1. 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.
  2. 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.
  3. Imposta le connessioni massime su uno o due dispositivi per biglietto, così un codice non può essere condiviso con tutto il pubblico.
  4. 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.

  1. Registra ogni palco e aggiungi i file alla libreria come episodi di una serie per percorso, oppure importali con il job di ingest VOD.
  2. Concedi le registrazioni tramite un bouquet e un pacchetto dedicati, così i partecipanti mantengono l'accesso dopo la scadenza delle linee live.
  3. Verifica la riproduzione delle registrazioni con una linea di test di quel pacchetto prima di annunciarle.

Canali dei palchi

Un palco come canale live.

  1. Aggiungi uno stream live per palco con l'invio RTMP dell'encoder e inseriscilo nei bouquet dei tipi di biglietto che possono guardarlo.
  2. Attiva il catch-up così un partecipante che ha perso l'inizio di una sessione può tornare indietro.
  3. 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.

  1. Dai a ogni pacchetto di biglietto una durata che termini con l'ultimo giorno dell'evento, così le linee scadono senza alcun lavoro.
  2. 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.
  3. 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.

  1. Il sistema di biglietteria o di registrazione crea le linee tramite la Reseller API e ascolta webhook come line.created e line.expired.
  2. 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.
  3. 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.

  1. Servi il pannello e l'URL base di riproduzione via TLS e imposta TRUSTED_PROXIES sul tuo reverse proxy.
  2. Accesso a due fattori per ogni account del pannello e gruppi di permessi perché la biglietteria non possa modificare i palchi.
  3. Link di riproduzione firmati e con scadenza e un limite di connessioni basso per biglietto.
  4. 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.

  1. Un partecipante non riesce ad aprire un palco: controlla il pacchetto della linea, il bouquet che contiene il palco e la data di scadenza.
  2. Un palco si blocca in sala ma non online: controlla l'heartbeat del nodo della sede e il percorso degli schermi verso di esso.
  3. Un codice di attivazione viene rifiutato: controlla che non sia già stato usato e che il suo pacchetto sia ancora valido.
  4. Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.