Dessa guider kopplar en branschs begrepp till de objekt som plattformen har i dag (bouquets, linjer, paket, partnerkonton, noder, API:et). De är begreppsmässiga motsvarigheter, inte branschspecifika funktioner, och ett partnerkonto är ett delegerat konto, inte en isolerad hyresgäst.
Begreppsmässig mappning
Inget i panelen heter rum eller vistelse. Tabellen visar vilket objekt som spelar vilken roll; kapitlen nedan sätter upp dem i den ordningen.
| I din bransch | På plattformen | Var i panelen |
|---|---|---|
| Hotelloperatör eller auktoriserad partner | Partnerkonto (återförsäljare): en delegerad panel med krediter, behörigheter och egna linjer | Users → lägg till en återförsäljare; Groups för dess behörigheter |
| Kanalpaket | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Rum eller enhet | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Hotellets informationsvideor | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Licensierade TV-kanaler | Live-kanal: en ström med sina källor, EPG och utdataformat | Strömmar → lägg till en live-ström (käll-URL eller RTMP-push) |
| Vistelsens längd | Linjens förfallodatum, som förnyas av ett paket, en kredit eller API:et | Linjens förfallodatum och paketets varaktighet |
| En nod per byggnad eller flygel | Streamingnoder: edge-servrar som registreras från panelen, en per plats eller byggnad | Servers → lägg till en nod, installerad via SSH |
Förutsättningar
Vad du ska ha innan du installerar.
- En server i anläggningens nät (Ubuntu 22.04 eller 24.04), installationsprogrammet och en adress som rummens enheter kan nå.
- De kanalflöden som anläggningen har rättigheter till (pull-URL:er eller RTMP), hotellets informationsvideor och rummens enheter (Android TV-boxar, MAG- eller Enigma2-boxar, smart-TV med en spelarapp eller en webbläsare).
- PMS:ets förmåga att anropa ett HTTP-API vid incheckning och utcheckning, eller en rutin i receptionen för att göra det i panelen.
Driftsättning av infrastrukturen
Den centrala servern och en nod per byggnad.
- Kör installationsprogrammet på den centrala servern; ange uppspelningsbasen till anläggningens interna adress så att rummen stannar i det lokala nätet.
- Lägg till kanalflödena under Strömmar och informationsvideorna under Movies; kontrollera dem i webbspelaren.
- Registrera en nod per flygel eller byggnad via Servers; panelen installerar den via SSH och dirigerar den byggnadens rum till den.
- Ange licensnyckeln på servern; aktiveringen sker på plats och tjänsten fortsätter köra utan uppkopplingen.
Organisation av innehållet
Kanalpaket och hotellvideor.
- Skapa en bouquet per kanalpaket (standardrum, sviter, konferens) av anläggningens kanaler.
- Skapa en bouquet med hotellvideor (välkomst, faciliteter, säkerhet) och lägg till den i varje paket.
- Skapa ett paket per rumskategori med de bouquets det ger tillgång till och en varaktighet på en dag: vid incheckning förnyas rummets linje en gång per natt under vistelsen (varje förnyelse lägger till paketets varaktighet) och vid utcheckning inaktiveras den (kapitel 8).
- Sortera kanalerna och ge dem logotyper så att menyn på TV:n blir lättläst.
Konfiguration av partner (återförsäljare)
Anläggningen, eller en operatör som driver flera anläggningar, som ett delegerat konto.
- Skapa en grupp med behörigheter begränsade till linjer (rum) och inga katalogändringar.
- Lägg till anläggningens reception, eller operatören, som återförsäljare med den gruppen och rumspaketen.
- En operatör med flera anläggningar får en återförsäljare per anläggning, var och en med egna rum och krediter.
Konfiguration av rum (linje)
En linje per rum, med nummer som namn.
- Skapa en linje per rum under Linjer med rumsnumret som namn och rumskategorins paket.
- Ställ in max antal anslutningar på 1 (en TV) eller på antalet skärmar i rummet.
- Bind linjen till rumsenhetens adress när nätet ger enheterna fasta adresser.
- Konfigurera enheten (Xtream Codes API eller M3U med linjens inloggningsuppgifter, eller MAG- / Enigma2-portalen) en gång; inloggningsuppgifterna stannar kvar med rummet.
Hotellets informationsvideor
Anläggningens egna videor på begäran.
- Ladda upp välkomst- och informationsvideorna som filmer, med anläggningens språkversioner som separata poster eller ljudspår.
- Lägg dem i bouqueten med hotellvideor så att varje rumskategori får dem.
- Uppdatera dem från panelen när informationen ändras; rummen ser den nya versionen direkt.
Licensierade TV-kanaler
Anläggningens kanaler som live-strömmar.
- Lägg till varje licensierad kanal under Strömmar med dess flöde; aktivera timeshift eller catch-up bara där licensen tillåter det.
- Lägg till en EPG-källa så att guiden på TV:n visar programmen.
- Håll territoriebegränsade kanaler i bouquets som bara rätt paket ger tillgång till.
Incheckning, utcheckning och förfallodatum
Vistelsen som linjens giltighet.
- Vid incheckning aktiverar du rummets linje och förnyar den för vistelsens längd (PMS:et via API:et, eller receptionen i panelen).
- Vid utcheckning inaktiverar du linjen; en ny vistelse aktiverar den igen, så inloggningsuppgifterna lämnar aldrig rummet.
- Prenumerera på webhooks med PMS:et eller receptionen för att se aktiverade, inaktiverade och utgångna linjer.
Integration med PMS:et
Incheckning och utcheckning styr rummen.
- Skapa en Reseller API-nyckel för PMS:et och förvara den i PMS:ets konfiguration.
- Vid incheckning anropar PMS:et action=enable_line och action=renew_line för rummets linje med ett begärans-id; vid utcheckning action=disable_line.
- Gästtjänstapplikationen (ring personal, städning, expressutcheckning, rumsservice) och dess back office-koppling ingår i Enterprise-planen och avgränsas tillsammans med anläggningen.
Säkerhetsaspekter
Håll kanalerna inom anläggningen.
- Håll uppspelningsbasen och noderna i anläggningens nät; exponera inget mot internet som rummen inte behöver.
- En anslutning per rum, bunden till enheten; signerade länkar går ut, så en kopierad länk slutar fungera.
- Tvåfaktorsinloggning för panelen; receptionen får en begränsad behörighetsgrupp.
- Aktivera den krypterade databassäkerhetskopian; rummens inloggningsuppgifter finns i den.
Felsökning
De vanliga första kontrollerna.
- Ett rum har ingen TV: kontrollera att dess linje är aktiverad och inte har gått ut, sedan enhetens inloggningsuppgifter och adress.
- En kanal saknas i ett rum: kontrollera bouqueten i rumskategorins paket.
- TV:n stannar under ett internetavbrott: kontrollera att uppspelningsbasen och källorna är interna adresser; externa flöden är beroende av uppkopplingen.
- PMS-anropet misslyckas: kontrollera API-nyckeln, att skrivningar är POST och begärans-id vid nya försök.