Ces guides font correspondre les concepts d'un secteur aux objets que la plateforme possède aujourd'hui (bouquets, lines, packages, comptes revendeurs, nœuds, l'API). Ce sont des correspondances conceptuelles, pas des fonctionnalités propres à un secteur, et un compte revendeur est un compte délégué, pas un locataire isolé.
Correspondance conceptuelle
Rien dans le panneau ne s'appelle une chambre ou un séjour. Le tableau indique quel objet joue quel rôle ; les chapitres suivants les configurent dans cet ordre.
| Dans votre secteur | Sur la plateforme | Où dans le panneau |
|---|---|---|
| Exploitant hôtelier ou partenaire agréé | Compte revendeur : un tableau de bord délégué avec crédits, permissions et ses propres lines | Users → ajouter un revendeur ; Groups pour ses permissions |
| Package de chaînes | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Chambre ou appareil | Line : un accès avec son package, ses bouquets, son expiration, sa limite de connexions et ses sorties | Lines → ajouter, ou codes d'activation, ou la Reseller API |
| Vidéos d'information de l'hôtel | Catalogue VOD : films et séries avec saisons et épisodes, catégories et métadonnées | Movies et Series, ou la tâche d'ingestion VOD |
| Chaînes de télévision sous licence | Chaîne en direct : un stream avec ses sources, son EPG et ses formats de sortie | Streams → ajouter un stream en direct (URL source ou push RTMP) |
| Durée du séjour | Date d'expiration de la line, renouvelée par un package, un crédit ou l'API | La date d'expiration de la line et la durée du package |
| Un nœud par bâtiment ou par aile | Nœuds de streaming : serveurs edge enrôlés depuis le panneau, un par site ou par bâtiment | Servers → ajouter un nœud, installé par SSH |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur sur le réseau de l'établissement (Ubuntu 22.04 ou 24.04), l'installateur et une adresse que les appareils des chambres peuvent atteindre.
- Les flux de chaînes dont l'établissement détient les droits (URL de récupération ou RTMP), les vidéos d'information de l'hôtel et les appareils des chambres (boîtiers Android TV, décodeurs MAG ou Enigma2, smart TV avec une application de lecture ou un navigateur).
- La capacité du PMS à appeler une API HTTP à l'arrivée et au départ, ou une procédure de réception pour le faire dans le panneau.
Déploiement de l'infrastructure
Le serveur central et un nœud par bâtiment.
- Lancez l'installateur sur le serveur central ; définissez la base de lecture sur l'adresse interne de l'établissement pour que les chambres restent sur le réseau local.
- Ajoutez les flux de chaînes sous Streams et les vidéos d'information sous Movies ; vérifiez-les dans le lecteur web.
- Enrôlez un nœud par aile ou par bâtiment depuis Servers ; le panneau l'installe par SSH et y dirige les chambres de ce bâtiment.
- Définissez la clé de licence sur le serveur ; l'activation se fait sur place et le service fonctionne sans la liaison externe.
Organisation du contenu
Packages de chaînes et vidéos de l'hôtel.
- Créez un bouquet par package de chaînes (chambres standard, suites, conférence) à partir des chaînes de l'établissement.
- Créez un bouquet de vidéos de l'hôtel (bienvenue, équipements, sécurité) et ajoutez-le à chaque package.
- Créez un package par catégorie de chambre, avec les bouquets qu'il accorde et une durée d'un jour : à l'arrivée, la ligne de la chambre est renouvelée une fois par nuit du séjour (chaque renouvellement ajoute la durée du package), et au départ elle est désactivée (chapitre 8).
- Ordonnez les chaînes et donnez-leur des logos pour que le menu du téléviseur soit lisible.
Configuration des partenaires (revendeurs)
L'établissement, ou un exploitant de plusieurs établissements, comme compte délégué.
- Créez un groupe avec des permissions limitées aux lines (chambres) et sans modification du catalogue.
- Ajoutez la réception de l'établissement, ou l'exploitant, comme revendeur avec ce groupe et les packages de chambre.
- Un exploitant de plusieurs établissements obtient un revendeur par établissement, chacun avec ses propres chambres et crédits.
Configuration des chambres (lines)
Une line par chambre, nommée par son numéro.
- Créez une line par chambre sous Lines avec le numéro de chambre comme nom et le package de la catégorie de chambre.
- Définissez les connexions max. à 1 (un téléviseur) ou au nombre d'écrans de la chambre.
- Liez la line à l'adresse de l'appareil de la chambre lorsque le réseau attribue des adresses fixes aux appareils.
- Configurez l'appareil une fois (API Xtream Codes ou M3U avec les identifiants de la line, ou le portail MAG / Enigma2) ; les identifiants restent avec la chambre.
Vidéos d'information de l'hôtel
Les vidéos propres à l'établissement à la demande.
- Téléversez les vidéos de bienvenue et d'information comme des films, avec les versions linguistiques de l'établissement en entrées séparées ou en pistes audio.
- Placez-les dans le bouquet des vidéos de l'hôtel pour que chaque catégorie de chambre les reçoive.
- Mettez-les à jour depuis le panneau chaque fois que l'information change ; les chambres voient la nouvelle version immédiatement.
Chaînes de télévision sous licence
Les chaînes de l'établissement comme streams en direct.
- Ajoutez chaque chaîne sous licence sous Streams avec son flux ; activez le timeshift ou le catch-up seulement là où la licence le permet.
- Ajoutez une source EPG pour que le guide du téléviseur affiche les programmes.
- Gardez les chaînes limitées par territoire dans des bouquets que seuls les bons packages accordent.
Arrivée, départ et expiration
Le séjour comme validité de la line.
- À l'arrivée, activez la line de la chambre et renouvelez-la pour la durée du séjour (le PMS via l'API, ou la réception dans le panneau).
- Au départ, désactivez la line ; un nouveau séjour la réactive, de sorte que les identifiants ne quittent jamais la chambre.
- Abonnez le PMS ou la réception aux webhooks pour voir les lines activées, désactivées et expirées.
Intégration avec le PMS
L'arrivée et le départ pilotent les chambres.
- Créez une clé Reseller API pour le PMS et conservez-la dans la configuration du PMS.
- À l'arrivée, le PMS appelle action=enable_line et action=renew_line pour la line de la chambre avec un identifiant de requête ; au départ, action=disable_line.
- L'application de services aux clients (appeler le personnel, ménage, départ express, service en chambre) et sa connexion back-office relèvent de l'offre Enterprise et sont cadrées avec l'établissement.
Considérations de sécurité
Gardez les chaînes à l'intérieur de l'établissement.
- Gardez la base de lecture et les nœuds sur le réseau de l'établissement ; n'exposez à Internet rien dont les chambres n'ont pas besoin.
- Une connexion par chambre, liée à l'appareil ; les liens signés expirent, donc un lien copié cesse de fonctionner.
- Connexion en deux étapes pour le panneau ; la réception obtient un groupe de permissions limité.
- Activez la sauvegarde chiffrée de la base de données ; les identifiants des chambres s'y trouvent.
Dépannage
Les premières vérifications habituelles.
- Une chambre n'a pas de télévision : vérifiez que sa line est activée et non expirée, puis les identifiants et l'adresse de l'appareil.
- Une chaîne manque dans une chambre : vérifiez le bouquet du package de la catégorie de chambre.
- La télévision s'arrête pendant une coupure Internet : vérifiez que la base de lecture et les sources sont des adresses internes ; les flux externes dépendent de la liaison externe.
- L'appel du PMS échoue : vérifiez la clé d'API, que les écritures sont en POST, et l'identifiant de requête lors des nouveaux essais.