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 salle ou adhérent. Le tableau indique quel objet joue quel rôle ; les chapitres ci-dessous les configurent dans cet ordre.
| Dans votre secteur | Sur la plateforme | Où dans le panneau |
|---|---|---|
| Film d'exposition et archives | 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 |
| Diffusion d'inauguration ou de conférence | 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) |
| Collection des salles ou des adhérents | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Accès visiteur ou adhérent | 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 |
| Période d'adhésion | 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 |
| Appareils par adhérent | Connexions max. de la line : combien d'appareils peuvent regarder en même temps | Les connexions max. de la line |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur dans le bâtiment (Ubuntu 22.04 ou 24.04), l'installateur, et le réseau des salles que les écrans et les appareils des adhérents utiliseront.
- Le film d'exposition, les enregistrements d'archives dont vous détenez les droits, un encodeur pour l'auditorium, et les écrans ou lecteurs multimédias pour les salles.
- La clé de licence et, si le bâtiment n'a pas internet, la procédure d'activation hors ligne ; et une décision sur qui à l'accueil vend les adhésions.
Déploiement de l'infrastructure
Le serveur dans le bâtiment, activé sur place.
- Lancez l'installateur sur le serveur et définissez l'URL de base de lecture sur l'adresse que le réseau des salles atteint.
- Activez la clé de licence hors ligne depuis le panneau ; après l'activation, le service fonctionne sur le réseau local sans internet.
- Ajoutez le film d'exposition sous Movies et le flux de l'auditorium sous Streams, et vérifiez-les dans le lecteur web.
- Pour un deuxième site ou un grand programme public, enrôlez un nœud depuis Servers ; le panneau l'installe par SSH et y dirige les spectateurs de ce site.
Organisation du contenu
Salles, archives et collections des adhérents.
- Créez des catégories par exposition et par année, et une série pour un cycle de conférences avec un épisode par conférence.
- Créez un bouquet pour les écrans des salles et un pour la bibliothèque des adhérents de conférences et de films d'archives.
- Créez un package pour les salles et un par type d'adhésion, chacun accordant ses bouquets ; la durée du package d'adhésion est la période d'adhésion.
- Ajoutez des affiches et de courtes descriptions à chaque film pour que la bibliothèque se lise bien dans le lecteur.
Configuration des partenaires (revendeurs)
L'accueil et la boutique comme comptes délégués.
- Créez un groupe avec des permissions limitées aux lines et aux codes d'activation, et sans accès au catalogue ni aux serveurs.
- Ajoutez l'accueil, ou la boutique, comme revendeur avec ce groupe, les packages d'adhésion et un solde de crédits.
- Un centre culturel qui exploite plusieurs lieux peut ajouter un revendeur par lieu, chacun vendant des adhésions sur son propre solde.
Configuration de l'accès des visiteurs et des adhérents
Des écrans et des adhérents sur des lines.
- Créez une line par écran de salle sous Lines → ajouter avec le package des salles, et liez-la à l'adresse de l'écran quand le réseau donne des adresses fixes.
- Créez des codes d'activation à l'accueil pour chaque adhésion vendue ; l'adhérent saisit le code dans le lecteur et la line démarre.
- Définissez les connexions max. par adhésion sur le nombre d'appareils qu'un adhérent peut utiliser, en général deux.
- Remettez à l'adhérent l'application de lecture, une playlist M3U ou l'adresse du lecteur web, selon ce qui convient à son appareil.
Film d'exposition et archives
La bibliothèque à la demande.
- Téléversez le film d'exposition et les archives numérisées comme films, ou ingérez-les avec la tâche d'ingestion VOD dans la racine des médias.
- Ajoutez les métadonnées TMDB quand elles existent, et rédigez vous-même le titre et la description pour le reste.
- Gardez les archives qui ne sont pas destinées au public dans le seul bouquet des adhérents, et vérifiez avec une line de test ce que voit chaque package.
Inaugurations et conférences
Un événement comme chaîne en direct.
- Ajoutez un flux en direct pour l'encodeur de l'auditorium (push RTMP) et placez-le dans le bouquet des adhérents, ou dans le bouquet des salles pour une inauguration montrée sur les écrans.
- Activez le catch-up pour qu'un adhérent qui arrive en retard puisse revenir en arrière, et téléversez l'enregistrement dans la bibliothèque ensuite.
- Testez l'encodeur et le flux avant l'événement avec une line de test, sur le même réseau que celui qu'utilisera le public.
Expiration et renouvellement de l'adhésion
L'adhésion comme validité de la line.
- Une line expire à la fin de la période de son package ; un renouvellement à l'accueil ajoute une nouvelle période.
- Désactivez une line quand une adhésion est résiliée ; les codes d'activation jamais utilisés restent inutilisés jusqu'à ce qu'ils soient échangés.
- Abonnez la boutique ou le système d'adhésion aux webhooks pour voir les lines sur le point d'expirer ou déjà expirées.
Intégration avec la boutique ou le système d'adhésion
Les systèmes vendent l'accès ; le lecteur lit.
- Créez une clé Reseller API pour la boutique ou le système d'adhésion ; il appelle create_line, renew_line et disable_line, avec un identifiant de requête sur chaque écriture.
- Utilisez un connecteur e-commerce quand les adhésions sont vendues en ligne ; tout autre système utilise la Reseller API et les webhooks.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : un adhérent se connecte au lecteur avec les identifiants de la line ou le code d'activation.
Considérations de sécurité
Garder les collections là où elles doivent être.
- Gardez le réseau des salles séparé du réseau des visiteurs, et servez tout accès public derrière un reverse proxy avec TLS et TRUSTED_PROXIES défini.
- Connexion en deux étapes pour chaque compte du panneau ; l'accueil reçoit un groupe de permissions limité aux lines et aux codes.
- Liens de lecture signés et expirants, une limite de connexions par adhésion, et liaison à l'adresse pour les écrans des salles.
- Activez la sauvegarde chiffrée de la base de données avec copie externe, et utilisez le journal d'audit pour revoir les modifications des lines et du catalogue.
Dépannage
Les premières vérifications habituelles.
- Un écran de salle est noir : vérifiez que sa line est activée et non expirée, la liaison à l'adresse de l'écran, et que le serveur est joignable sur le réseau des salles.
- Le code d'un adhérent ne fonctionne pas : vérifiez que le code n'a pas déjà été échangé et que le package qu'il ouvre est toujours attribué à l'accueil.
- L'activation de la licence échoue hors ligne : vérifiez le fichier d'activation par rapport à la clé de licence et à l'horloge du serveur.
- L'inauguration en direct saccade : vérifiez le débit de l'encodeur par rapport à la liaison montante et l'état du flux sous Streams.