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 un cours ou un étudiant. 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 |
|---|---|---|
| Centre de formation ou partenaire de distribution | 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 |
| Ensemble de cours | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Cours enregistrés | 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 |
| Cours en direct | 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) |
| Accès étudiant | 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'accès au cours | 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 |
| Limite de sessions simultanées | Connexions max. de la line : combien d'appareils peuvent regarder en même temps | Les connexions max. de la line |
| Intégration LMS ou e-commerce | 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 Linux (Ubuntu 22.04 ou 24.04) sur le réseau du campus avec Postgres, Redis et ffmpeg installés par l'installateur, et un domaine ou une adresse interne pour le panneau et le lecteur.
- Les enregistrements que vous publierez (fichiers ou système de captation capable d'envoyer du RTMP) et, pour les cours en direct, un encodeur dans chaque salle qui diffusera.
- Une clé de licence : l'offre Free n'en demande aucune ; les établissements éligibles demandent la clé Professional gratuite par e-mail depuis leur domaine académique.
Déploiement de l'infrastructure
Installez le serveur de gestion, puis un nœud par bâtiment.
- Lancez l'installateur sur le serveur de gestion ; il installe le panneau, l'API, le worker et l'origine comme unités systemd et crée le premier administrateur.
- Définissez l'URL publique de l'API (API_PUBLIC_URL) et la base de lecture afin que les liens du lecteur pointent vers l'adresse du campus.
- Enrôlez un nœud depuis Servers → ajouter un nœud pour chaque bâtiment dont les salles regarderont ; le panneau l'installe par SSH à partir du package de nœud.
- Vérifiez la page Servers : le nœud signale son heartbeat et son trafic, et les spectateurs de ce bâtiment y sont dirigés.
Organisation du contenu
Les cours comme séries, les cursus comme bouquets et packages.
- Créez une catégorie par faculté ou par matière sous Movies / Series.
- Ajoutez chaque cours comme une série : une saison par module, un épisode par leçon, avec l'enregistrement comme source (téléversement ou tâche d'ingestion VOD).
- Créez un bouquet par ensemble de cours (par exemple les cours d'un cursus pour une période) à partir des séries ajoutées.
- Créez un package par cursus : les bouquets qu'il accorde, la période d'accès comme durée et la limite de sessions simultanées.
Configuration des partenaires (revendeurs)
Un centre de formation ou une faculté comme compte délégué.
- Créez sous Groups un groupe avec les permissions dont le centre a besoin (ses propres lines, aucune modification du catalogue).
- Ajoutez le centre comme revendeur sous Users avec ce groupe, un solde de crédits et les packages qu'il peut attribuer.
- Donnez-lui l'adresse du tableau de bord ; il y gère ses propres étudiants, et le panneau conserve le journal d'audit.
Configuration de l'accès des étudiants
Une line par étudiant, créée à l'inscription.
- Pour de petites promotions, ajoutez des lines depuis Lines → ajouter avec le package du cursus ; l'expiration suit la durée du package.
- Pour le jour de l'inscription, générez des codes d'activation pour le package ; un étudiant utilise un code dans le lecteur et obtient une line.
- Pour un système étudiant ou un LMS, créez une clé Reseller API et laissez le système créer des lines avec action=create_line et un identifiant de requête par étudiant.
- Définissez les connexions max. au nombre d'appareils qu'un étudiant peut utiliser en même temps ; le lecteur refuse la connexion suivante au-delà.
Configuration de la VOD
Les cours enregistrés à la demande.
- Téléversez chaque enregistrement comme source d'un épisode, ou pointez la tâche d'ingestion VOD vers le fichier et laissez le worker le télécharger et l'encoder dans la racine des médias.
- Renseignez les métadonnées (titre, description, affiche) à la main ou depuis TMDB pour le matériel public ; les cours n'ont généralement besoin que d'un titre et d'une description.
- Vérifiez la lecture dans le lecteur web avec une line de test ; le lien est signé et expire après la durée configurée.
Streaming de cours en direct
Un cours magistral comme chaîne en direct.
- Ajoutez un stream en direct sous Streams avec l'encodeur de la salle comme source (une adresse de push RTMP ou une URL de récupération).
- Placez le stream dans le bouquet du cours pour que seuls les étudiants inscrits le voient ; ajoutez-le à l'EPG si vous tenez un emploi du temps.
- Activez le catch-up ou le timeshift sur le stream lorsque les étudiants peuvent regarder un cours plus tard ; l'enregistrement peut aussi être téléversé comme épisode.
Abonnement et expiration de l'accès
Un accès qui se termine avec le cours.
- Donnez au package la période d'accès comme durée ; une line créée à partir de lui expire à la fin de cette période.
- Renouvelez une line pour une nouvelle période depuis le panneau, avec un crédit du centre, ou via l'API avec action=renew_line.
- Abonnez votre système aux webhooks : il est informé lorsqu'une line est sur le point d'expirer, a expiré ou a été désactivée.
Intégration avec un LMS externe
Le LMS pilote l'accès ; le lecteur lit.
- Créez une clé Reseller API pour le LMS ; conservez-la dans les secrets du LMS, jamais dans une page.
- À l'inscription, le LMS appelle action=create_line avec le package du cursus et un identifiant de requête ; au retrait, action=disable_line.
- Faites un lien depuis la page de cours du LMS vers le lecteur web ou donnez à l'étudiant les identifiants du lecteur ; il n'y a pas de connexion unique entre les deux.
Considérations de sécurité
Gardez le service à l'intérieur de l'établissement.
- Activez la connexion en deux étapes pour chaque compte du panneau et donnez au personnel le plus petit groupe de permissions qui fonctionne.
- Gardez les données personnelles des étudiants dans le système étudiant ; la line n'a besoin que d'un nom et d'une expiration.
- Gardez les connexions max. basses et envisagez de lier la lecture à l'adresse du spectateur pour éviter le partage.
- Activez la sauvegarde chiffrée de la base de données et, si vous avez un stockage compatible S3, la copie externe.
Dépannage
Les premières vérifications habituelles.
- Un étudiant ne peut pas se connecter : vérifiez l'expiration de la line et qu'elle est activée, puis le package et le bouquet du cours.
- Un enregistrement ne se lit pas : vérifiez le résultat de la tâche d'ingestion sur la page Jobs, puis le fichier dans la racine des médias et l'expiration du lien signé.
- Les spectateurs d'un bâtiment atteignent l'origine : vérifiez le heartbeat du nœud et que l'adresse du spectateur entre dans le routage du nœud.
- L'API refuse un appel : vérifiez la clé, la méthode de l'action (les écritures sont en POST) et l'identifiant de requête d'un appel rejoué.