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 scène ou billet. 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 |
|---|---|---|
| Chaîne de scène | 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) |
| Type de billet | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Billet ou pass | 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 |
| Fin de l'événement | 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 billet | Connexions max. de la line : combien d'appareils peuvent regarder en même temps | Les connexions max. de la line |
| Intégration billetterie ou inscription | Reseller API et webhooks : les opérations du panneau depuis votre propre système | Clés Reseller API et webhooks dans le tableau de bord du revendeur |
| Nœud du lieu | 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 (Ubuntu 22.04 ou 24.04) avec une adresse publique ou un domaine et une liaison montante pour le pic d'audience attendu, et, pour un nœud sur le lieu, une machine sur le réseau du lieu.
- Un encodeur par scène capable de pousser en RTMP, et la liste des scènes, des jours et des types de billets.
- Une décision sur la façon dont les billets arrivent dans le panneau : codes d'activation générés en masse, ou système de billetterie appelant la Reseller API.
Déploiement de l'infrastructure
L'origine d'abord, puis le lieu.
- Lancez l'installateur sur le serveur de gestion et placez le panneau derrière un reverse proxy avec TLS ; définissez les proxys de confiance pour que les règles d'IP voient l'adresse réelle du spectateur.
- Définissez l'URL de base de lecture sur l'adresse publique que les participants atteignent.
- Enrôlez un nœud depuis Servers sur la machine du lieu ; le panneau l'installe par SSH, et les écrans locaux y sont dirigés.
- Créez un compte partenaire (revendeur) pour le guichet de billetterie avec des permissions sur les lines et aucune sur le catalogue.
Organisation du contenu
Des scènes en chaînes, des billets en packages.
- Ajoutez des catégories par jour ou par parcours pour que la liste des chaînes se lise comme le programme.
- Créez un bouquet par type de billet : les scènes que ce billet peut regarder.
- Créez un package par type de billet avec la durée de l'événement comme durée, et un package d'essai pour la presse et les intervenants si besoin.
- Créez un bouquet pour le flux de la scène ou du salon des sponsors et accordez-le uniquement via le package sponsor.
Configuration des partenaires (revendeurs)
Le guichet de billetterie, s'il émet l'accès.
- Créez pour le guichet de billetterie un groupe avec des permissions sur les lines et aucune sur le catalogue.
- Ajoutez le guichet comme revendeur avec ce groupe et assez de crédits pour les codes qu'il émettra.
- Un co-organisateur ou un partenaire régional qui vend ses propres billets reçoit son propre compte partenaire et ses propres packages.
Configuration de l'accès des participants
Une line par billet.
- Générez des codes d'activation en masse, un par billet, chacun lié au package de son type de billet, et imprimez-les ou envoyez-les par e-mail avec le billet.
- Pour la vente de billets en ligne, installez le connecteur de votre plateforme e-commerce, ou faites appeler action=create_line par le système de billetterie avec le package et un identifiant de requête.
- Définissez les connexions max. à un ou deux appareils par billet pour qu'un code ne puisse pas être partagé dans le public.
- Testez avec une line d'essai avant l'ouverture des portes, avec le même lecteur que celui qu'utiliseront les participants.
Enregistrements des sessions
Les enregistrements après l'événement.
- Enregistrez chaque scène et ajoutez les fichiers à la bibliothèque comme épisodes d'une série par parcours, ou ingérez-les avec la tâche d'ingestion VOD.
- Accordez les enregistrements via un bouquet et un package à part, pour que les participants gardent l'accès après l'expiration des lines en direct.
- Vérifiez la lecture des enregistrements avec une line de test de ce package avant de les annoncer.
Chaînes de scène
Une scène comme chaîne en direct.
- Ajoutez un flux en direct par scène avec le push RTMP de l'encodeur, et placez-le dans les bouquets des types de billets qui peuvent le regarder.
- Activez le catch-up pour qu'un participant qui a manqué le début d'une session puisse revenir en arrière.
- Vérifiez avant la première session que le nœud du lieu récupère chaque scène une seule fois depuis l'origine et que les écrans y sont dirigés.
Expiration
L'accès se termine avec l'événement.
- Donnez à chaque package de billet une durée qui se termine le dernier jour de l'événement, pour que les lines expirent sans travail.
- Prolongez une line, ou émettez un code de courte durée, pour un intervenant ou un sponsor tardif au lieu de créer un nouveau package.
- Désactivez depuis Lines la line d'un billet perdu ou partagé ; le journal d'audit conserve la trace.
Intégration avec la billetterie
Les systèmes pilotent l'accès ; le lecteur lit.
- Le système de billetterie ou d'inscription crée des lines via la Reseller API et écoute des webhooks comme line.created et line.expired.
- La vente de billets en ligne sur une plateforme e-commerce prise en charge utilise son connecteur ; il n'y a pas de connecteur natif pour un produit de billetterie en particulier.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : un participant se connecte au lecteur avec les identifiants de la line ou avec un code d'activation.
Considérations de sécurité
Un billet, une personne.
- Servez le panneau et l'URL de base de lecture en TLS et définissez TRUSTED_PROXIES sur votre reverse proxy.
- Connexion en deux étapes pour chaque compte du panneau, et groupes de permissions pour que le guichet de billetterie ne puisse pas modifier les scènes.
- Liens de lecture signés et expirants et limite de connexions basse par billet.
- Sauvegardes chiffrées de la base de données avec copie externe, et journal d'audit pour chaque modification des lines et des scènes.
Dépannage
Les premières vérifications habituelles.
- Un participant ne peut pas ouvrir une scène : vérifiez le package de la line, le bouquet qui contient la scène et la date d'expiration.
- Une scène se fige dans la salle mais pas en ligne : vérifiez le heartbeat du nœud du lieu et la route des écrans vers lui.
- Un code d'activation est refusé : vérifiez qu'il n'a pas déjà été utilisé et que son package est toujours valide.
- Le journal d'audit montre l'adresse du proxy : définissez TRUSTED_PROXIES sur le proxy et redémarrez le panneau.