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 camera o soggiorno. La tabella dice quale oggetto svolge quale ruolo; i capitoli qui sotto li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Operatore alberghiero o partner autorizzato | Account partner (reseller): una dashboard delegata con crediti, permessi e linee proprie | Users → aggiungi un reseller; Groups per i suoi permessi |
| Pacchetto di canali | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Camera o dispositivo | 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 |
| Video informativi dell'hotel | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Canali televisivi con licenza | 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) |
| Durata del soggiorno | 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 |
| Un nodo per edificio o ala | 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 sulla rete della struttura (Ubuntu 22.04 o 24.04), l'installer e un indirizzo raggiungibile dai dispositivi delle camere.
- I feed dei canali di cui la struttura detiene i diritti (URL di pull o RTMP), i video informativi dell'hotel e i dispositivi delle camere (box Android TV, box MAG o Enigma2, smart TV con un'app player o un browser).
- La capacità del PMS di chiamare un'API HTTP al check-in e al check-out, oppure una procedura della reception per farlo nel pannello.
Installazione dell'infrastruttura
Il server centrale e un nodo per edificio.
- Esegui l'installer sul server centrale; imposta la base di riproduzione sull'indirizzo interno della struttura così le camere restano sulla rete locale.
- Aggiungi i feed dei canali in Streams e i video informativi in Movies; verificali nel web player.
- Registra un nodo per ala o edificio da Servers; il pannello lo installa via SSH e instrada a lui le camere di quell'edificio.
- Imposta la chiave di licenza sul server; l'attivazione avviene in sede e il servizio funziona senza l'uplink.
Organizzazione dei contenuti
Pacchetti di canali e video dell'hotel.
- Crea un bouquet per ogni pacchetto di canali (camere standard, suite, congressi) a partire dai canali della struttura.
- Crea un bouquet di video dell'hotel (benvenuto, servizi, sicurezza) e aggiungilo a ogni pacchetto.
- Crea un pacchetto per categoria di camera, con i bouquet che concede e una durata di un giorno: al check-in la linea della camera viene rinnovata una volta per ogni notte del soggiorno (ogni rinnovo aggiunge la durata del pacchetto) e al check-out viene disattivata (capitolo 8).
- Ordina i canali e dai loro i loghi perché il menu sulla televisione sia leggibile.
Configurazione dei partner (reseller)
La struttura, o un operatore che gestisce più strutture, come account delegato.
- Crea un gruppo con permessi limitati alle linee (camere) e nessuna modifica al catalogo.
- Aggiungi la reception della struttura, o l'operatore, come reseller con quel gruppo e i pacchetti delle camere.
- Un operatore di più strutture ottiene un reseller per struttura, ciascuno con le proprie camere e i propri crediti.
Configurazione della camera (linea)
Una linea per camera, chiamata con il suo numero.
- Crea una linea per camera in Lines con il numero della camera come nome e il pacchetto della categoria di camera.
- Imposta le connessioni massime a 1 (una televisione) o al numero di schermi della camera.
- Lega la linea all'indirizzo del dispositivo della camera quando la rete assegna ai dispositivi indirizzi fissi.
- Configura il dispositivo una sola volta (API Xtream Codes o M3U con le credenziali della linea, oppure il portale MAG / Enigma2); le credenziali restano con la camera.
Video informativi dell'hotel
I video della struttura on demand.
- Carica i video di benvenuto e informativi come film, con le versioni nelle lingue della struttura come voci separate o tracce audio.
- Mettili nel bouquet dei video dell'hotel così ogni categoria di camera li riceve.
- Aggiornali dal pannello ogni volta che le informazioni cambiano; le camere vedono subito la nuova versione.
Canali televisivi con licenza
I canali della struttura come stream in diretta.
- Aggiungi ogni canale con licenza in Streams con il suo feed; abilita timeshift o catch-up solo dove la licenza lo consente.
- Aggiungi una fonte EPG così la guida sulla televisione mostra i programmi.
- Tieni i canali limitati a un territorio in bouquet che solo i pacchetti giusti concedono.
Check-in, check-out e scadenza
Il soggiorno come validità della linea.
- Al check-in attiva la linea della camera e rinnovala per la durata del soggiorno (il PMS tramite l'API, o la reception nel pannello).
- Al check-out disattiva la linea; un nuovo soggiorno la riattiva, così le credenziali non lasciano mai la camera.
- Iscrivi il PMS o la reception ai webhook per vedere le linee attivate, disattivate e scadute.
Integrazione con il PMS
Check-in e check-out governano le camere.
- Crea una chiave Reseller API per il PMS e tienila nella configurazione del PMS.
- Al check-in il PMS chiama action=enable_line e action=renew_line per la linea della camera con un id di richiesta; al check-out action=disable_line.
- L'applicazione per i servizi agli ospiti (chiamata del personale, pulizie, check-out rapido, servizio in camera) e il suo collegamento di back-office fanno parte del piano Enterprise e sono definiti insieme alla struttura.
Considerazioni sulla sicurezza
Tieni i canali dentro la struttura.
- Tieni la base di riproduzione e i nodi sulla rete della struttura; non esporre a internet nulla di cui le camere non abbiano bisogno.
- Una connessione per camera, legata al dispositivo; i link firmati scadono, quindi un link copiato smette di funzionare.
- Accesso a due fattori per il pannello; la reception ottiene un gruppo di permessi limitato.
- Attiva il backup cifrato del database; le credenziali delle camere ci sono dentro.
Risoluzione dei problemi
I primi controlli abituali.
- Una camera non ha la televisione: controlla che la sua linea sia attiva e non scaduta, poi le credenziali e l'indirizzo del dispositivo.
- In una camera manca un canale: controlla il bouquet del pacchetto della categoria di camera.
- La televisione si ferma durante un'interruzione di internet: controlla che la base di riproduzione e le fonti siano indirizzi interni; i feed esterni dipendono dall'uplink.
- La chiamata del PMS fallisce: controlla la chiave API, che le scritture siano POST e l'id di richiesta nei nuovi tentativi.