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 émission ou soutien. 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 |
|---|---|---|
| La chaîne du studio | 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) |
| Bibliothèque d'émissions | 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 |
| Niveau d'abonnement | 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 du soutien | 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 de facturation | 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 |
| Compte d'affilié ou de distributeur | 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 |
| Intégration boutique ou adhésion | 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 |
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 assez de bande passante montante pour l'audience attendue.
- Les épisodes terminés, le playout ou l'encodeur du studio pour la chaîne, et une boutique sur une plateforme dotée d'un connecteur, ou la capacité d'appeler une API HTTP.
- Une décision sur les niveaux et sur les affiliés : ce que chaque abonnement accorde, et qui peut le vendre.
Déploiement de l'infrastructure
Un serveur d'abord, des nœuds quand l'audience grandit.
- 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 votre audience atteint.
- Enrôlez un nœud depuis Servers dans une région où de nombreux soutiens regardent ; le panneau l'installe par SSH et y dirige les spectateurs de cette région.
- Créez un compte partenaire (revendeur) pour chaque membre de l'équipe qui gère le catalogue ou les soutiens, avec son propre groupe de permissions.
Organisation du contenu
Des émissions en séries, des niveaux en bouquets.
- Créez des catégories par genre, et une série par émission avec une saison par lot de sorties et un épisode par vidéo.
- Créez un bouquet pour la chaîne en direct, un pour le contenu gratuit ou d'entrée de gamme et un pour chaque niveau supérieur.
- Créez un package par niveau avec la période de facturation comme durée, un package d'essai pour les nouveaux visiteurs si vous en voulez un, et un prix en crédits pour les affiliés.
- Gardez le catalogue d'archives dans sa propre catégorie pour pouvoir le déplacer d'un niveau à l'autre sans toucher aux séries.
Configuration des partenaires (revendeurs)
Affiliés et distributeurs.
- Créez un groupe pour les affiliés avec uniquement des permissions sur les lines, pour qu'ils ne puissent pas modifier le catalogue.
- Ajoutez chaque affilié comme revendeur avec ce groupe et un solde de crédits ; le prix de son package est ce que le studio décide.
- Un distributeur ayant des sous-affiliés peut créer des sous-revendeurs sous son propre compte, jusqu'à cinq niveaux de profondeur.
Configuration de l'accès des soutiens
Une line par soutien.
- Installez le connecteur de votre boutique (WooCommerce, par exemple) et saisissez la clé Reseller API et le package qui correspond à chaque produit.
- À l'abonnement, le connecteur appelle create_line avec le package et un identifiant de requête ; la période de facturation est la durée du package.
- Définissez les connexions max. sur le nombre d'appareils qu'un soutien peut utiliser, en général deux ou trois.
- Pour un jeu concours ou un lancement, générez des codes d'activation en masse ou ajoutez des lines depuis Lines → ajouter avec un package d'essai.
Bibliothèque d'émissions
Des épisodes à la demande.
- Téléversez chaque épisode comme source, ou ingérez-le avec la tâche d'ingestion VOD ; renseignez le titre, la saison, le numéro d'épisode et les métadonnées TMDB si l'émission en a.
- Rattachez chaque série aux bouquets des niveaux qui peuvent la regarder.
- Vérifiez la lecture avec une line de test de chaque niveau avant d'annoncer une sortie.
La chaîne du studio
Une chaîne en continu.
- Ajoutez un flux en direct pour le playout du studio (push RTMP) et placez-le dans les bouquets de chaque niveau qui inclut la chaîne.
- Chargez le guide de la chaîne en XMLTV pour que les soutiens voient ce qui est diffusé, et activez le catch-up pour les émissions qui valent la peine d'être revues.
- Gardez le playout actif entre les sorties avec le propre contenu programmé du studio ; le panneau ne fait que relayer le flux.
Expiration des abonnements
L'accès suit le paiement.
- Une line expire à la fin de la période de son package ; la boutique la renouvelle avec renew_line quand le paiement suivant arrive.
- Abonnez la boutique aux webhooks pour envoyer un rappel sur line.expiring et rétrograder un soutien sur line.expired.
- Un soutien qui résilie est désactivé par la boutique avec disable_line, et la line peut être renouvelée plus tard sans nouveau compte.
Intégration avec la boutique
La boutique vend ; le lecteur lit.
- Le connecteur crée, renouvelle et désactive les lines au rythme des commandes ; toute autre boutique utilise la Reseller API et les webhooks.
- Les affiliés voient leurs propres lines dans leur tableau de bord, et la Reseller API leur permet de l'automatiser.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs : les soutiens se connectent au lecteur avec les identifiants de leur line, que la boutique leur envoie.
Considérations de sécurité
Protégez l'abonnement, pas seulement le serveur.
- 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 les affiliés ne puissent pas modifier le catalogue.
- Liens de lecture signés et expirants et limite de connexions par line ; liez une line à un pays si une licence est territoriale.
- Sauvegardes chiffrées de la base de données avec copie externe, et journal d'audit pour chaque modification des lines et du catalogue.
Dépannage
Les premières vérifications habituelles.
- Un nouveau soutien ne peut pas regarder après avoir payé : vérifiez l'appel du connecteur de la boutique dans le journal de la Reseller API et la date d'expiration de la line.
- Un soutien voit du contenu d'un niveau supérieur : vérifiez le package de la line et les bouquets qu'il accorde.
- La chaîne s'arrête à la fin d'un cycle de playout : vérifiez le push de l'encodeur vers le flux en direct et l'état de la sonde du flux.
- La vente d'un affilié n'apparaît pas : vérifiez ses crédits et que le package utilisé appartient à son groupe.